most-box 0.1.3 → 0.1.5

package/out/web3/tools/index.txt

@@ -1,19 +1,19 @@
 1:"$Sreact.fragment"
-2:I[14232,["/_next/static/chunks/0_0oph_z1az14.js","/_next/static/chunks/0ysj5b94vu4ri.js","/_next/static/chunks/0t2xr05rlu96l.js","/_next/static/chunks/0m_5nb6x8qy._.js"],"ErrorBoundary"]
-3:I[52925,["/_next/static/chunks/0_0oph_z1az14.js","/_next/static/chunks/0ysj5b94vu4ri.js","/_next/static/chunks/0t2xr05rlu96l.js","/_next/static/chunks/0m_5nb6x8qy._.js"],"default"]
-4:I[39756,["/_next/static/chunks/0_0oph_z1az14.js","/_next/static/chunks/0ysj5b94vu4ri.js","/_next/static/chunks/0t2xr05rlu96l.js","/_next/static/chunks/0m_5nb6x8qy._.js"],"default"]
-5:I[37457,["/_next/static/chunks/0_0oph_z1az14.js","/_next/static/chunks/0ysj5b94vu4ri.js","/_next/static/chunks/0t2xr05rlu96l.js","/_next/static/chunks/0m_5nb6x8qy._.js"],"default"]
-6:I[36768,["/_next/static/chunks/0_0oph_z1az14.js","/_next/static/chunks/0ysj5b94vu4ri.js","/_next/static/chunks/0t2xr05rlu96l.js","/_next/static/chunks/0m_5nb6x8qy._.js","/_next/static/chunks/0ao1lbi4b.sfa.js"],"default"]
-8:I[97367,["/_next/static/chunks/0_0oph_z1az14.js","/_next/static/chunks/0ysj5b94vu4ri.js","/_next/static/chunks/0t2xr05rlu96l.js","/_next/static/chunks/0m_5nb6x8qy._.js"],"OutletBoundary"]
+2:I[14232,["/_next/static/chunks/0ccalho416.d7.js","/_next/static/chunks/14jhy~xia8lh8.js","/_next/static/chunks/0t2xr05rlu96l.js"],"ErrorBoundary"]
+3:I[52925,["/_next/static/chunks/0ccalho416.d7.js","/_next/static/chunks/14jhy~xia8lh8.js","/_next/static/chunks/0t2xr05rlu96l.js"],"default"]
+4:I[39756,["/_next/static/chunks/0ccalho416.d7.js","/_next/static/chunks/14jhy~xia8lh8.js","/_next/static/chunks/0t2xr05rlu96l.js"],"default"]
+5:I[37457,["/_next/static/chunks/0ccalho416.d7.js","/_next/static/chunks/14jhy~xia8lh8.js","/_next/static/chunks/0t2xr05rlu96l.js"],"default"]
+6:I[36768,["/_next/static/chunks/0ccalho416.d7.js","/_next/static/chunks/14jhy~xia8lh8.js","/_next/static/chunks/0t2xr05rlu96l.js","/_next/static/chunks/02jvyg27pp0mz.js"],"default"]
+8:I[97367,["/_next/static/chunks/0ccalho416.d7.js","/_next/static/chunks/14jhy~xia8lh8.js","/_next/static/chunks/0t2xr05rlu96l.js"],"OutletBoundary"]
 9:"$Sreact.suspense"
-c:I[97367,["/_next/static/chunks/0_0oph_z1az14.js","/_next/static/chunks/0ysj5b94vu4ri.js","/_next/static/chunks/0t2xr05rlu96l.js","/_next/static/chunks/0m_5nb6x8qy._.js"],"ViewportBoundary"]
-e:I[97367,["/_next/static/chunks/0_0oph_z1az14.js","/_next/static/chunks/0ysj5b94vu4ri.js","/_next/static/chunks/0t2xr05rlu96l.js","/_next/static/chunks/0m_5nb6x8qy._.js"],"MetadataBoundary"]
-10:I[68027,["/_next/static/chunks/0_0oph_z1az14.js","/_next/static/chunks/0ysj5b94vu4ri.js","/_next/static/chunks/0t2xr05rlu96l.js","/_next/static/chunks/0m_5nb6x8qy._.js"],"default",1]
-:HL["/_next/static/chunks/0adx~d-j05c9d.css","style"]
+c:I[97367,["/_next/static/chunks/0ccalho416.d7.js","/_next/static/chunks/14jhy~xia8lh8.js","/_next/static/chunks/0t2xr05rlu96l.js"],"ViewportBoundary"]
+e:I[97367,["/_next/static/chunks/0ccalho416.d7.js","/_next/static/chunks/14jhy~xia8lh8.js","/_next/static/chunks/0t2xr05rlu96l.js"],"MetadataBoundary"]
+10:I[68027,["/_next/static/chunks/0ccalho416.d7.js","/_next/static/chunks/14jhy~xia8lh8.js","/_next/static/chunks/0t2xr05rlu96l.js"],"default",1]
+:HL["/_next/static/chunks/09h7l4i38xc7q.css","style"]
 :HL["/_next/static/chunks/0xdwau5k2augv.css","style"]
 :HL["/_next/static/chunks/0ukyg~tkm~h2m.css","style"]
 :HC["/",""]
-0:{"P":null,"c":["","web3","tools",""],"q":"","i":false,"f":[[["",{"children":["web3",{"children":["tools",{"children":["__PAGE__",{}]}]}]},"$undefined","$undefined",16],[["$","$1","c",{"children":[[["$","link","0",{"rel":"stylesheet","href":"/_next/static/chunks/0adx~d-j05c9d.css","precedence":"next","crossOrigin":"$undefined","nonce":"$undefined"}],["$","link","1",{"rel":"stylesheet","href":"/_next/static/chunks/0xdwau5k2augv.css","precedence":"next","crossOrigin":"$undefined","nonce":"$undefined"}],["$","script","script-0",{"src":"/_next/static/chunks/0_0oph_z1az14.js","async":true,"nonce":"$undefined"}],["$","script","script-1",{"src":"/_next/static/chunks/0ysj5b94vu4ri.js","async":true,"nonce":"$undefined"}],["$","script","script-2",{"src":"/_next/static/chunks/0t2xr05rlu96l.js","async":true,"nonce":"$undefined"}],["$","script","script-3",{"src":"/_next/static/chunks/0m_5nb6x8qy._.js","async":true,"nonce":"$undefined"}]],["$","html",null,{"lang":"zh-CN","suppressHydrationWarning":true,"data-scroll-behavior":"smooth","children":[["$","head",null,{"children":[["$","meta",null,{"charSet":"UTF-8"}],["$","meta",null,{"name":"viewport","content":"width=device-width, initial-scale=1.0"}],["$","link",null,{"rel":"icon","href":"/favicon.ico"}],["$","meta",null,{"name":"theme-color","content":"#5e6ad2"}],["$","script",null,{"dangerouslySetInnerHTML":{"__html":"\n              (function() {\n                var theme = localStorage.getItem('theme');\n                if (theme === 'dark' || (!theme && window.matchMedia('(prefers-color-scheme: dark)').matches)) {\n                  document.documentElement.setAttribute('data-theme', 'dark');\n                }\n              })();\n            "}}]]}],["$","body",null,{"children":["$","$L2",null,{"children":[["$","$L3",null,{}],["$","script",null,{"dangerouslySetInnerHTML":{"__html":"\n          window.onerror = function(message, source, lineno, colno, error) {\n            console.error('[Global Error]', { message, source, lineno, colno, error });\n          };\n          window.onunhandledrejection = function(event) {\n            console.error('[Unhandled Promise Rejection]', event.reason);\n          };\n        "}}],["$","$L4",null,{"parallelRouterKey":"children","error":"$undefined","errorStyles":"$undefined","errorScripts":"$undefined","template":["$","$L5",null,{}],"templateStyles":"$undefined","templateScripts":"$undefined","notFound":[["$","$L6",null,{}],[]],"forbidden":"$undefined","unauthorized":"$undefined"}]]}]}]]}]]}],{"children":[["$","$1","c",{"children":[[["$","link","0",{"rel":"stylesheet","href":"/_next/static/chunks/0ukyg~tkm~h2m.css","precedence":"next","crossOrigin":"$undefined","nonce":"$undefined"}]],["$","$L4",null,{"parallelRouterKey":"children","error":"$undefined","errorStyles":"$undefined","errorScripts":"$undefined","template":["$","$L5",null,{}],"templateStyles":"$undefined","templateScripts":"$undefined","notFound":"$undefined","forbidden":"$undefined","unauthorized":"$undefined"}]]}],{"children":[["$","$1","c",{"children":[null,["$","$L4",null,{"parallelRouterKey":"children","error":"$undefined","errorStyles":"$undefined","errorScripts":"$undefined","template":["$","$L5",null,{}],"templateStyles":"$undefined","templateScripts":"$undefined","notFound":"$undefined","forbidden":"$undefined","unauthorized":"$undefined"}]]}],{"children":[["$","$1","c",{"children":["$L7",null,["$","$L8",null,{"children":["$","$9",null,{"name":"Next.MetadataOutlet","children":"$@a"}]}]]}],{},null,false,null]},null,false,"$@b"]},null,false,null]},null,false,null],["$","$1","h",{"children":[null,["$","$Lc",null,{"children":"$Ld"}],["$","div",null,{"hidden":true,"children":["$","$Le",null,{"children":["$","$9",null,{"name":"Next.Metadata","children":"$Lf"}]}]}],null]}],false]],"m":"$undefined","G":["$10",[["$","link","0",{"rel":"stylesheet","href":"/_next/static/chunks/0adx~d-j05c9d.css","precedence":"next","crossOrigin":"$undefined","nonce":"$undefined"}],["$","link","1",{"rel":"stylesheet","href":"/_next/static/chunks/0xdwau5k2augv.css","precedence":"next","crossOrigin":"$undefined","nonce":"$undefined"}]]],"S":true,"h":null,"s":"$undefined","l":"$undefined","p":"$undefined","d":"$undefined","b":"aPEZ4zaaR5W3WpSZ0dFsa"}
+0:{"P":null,"c":["","web3","tools",""],"q":"","i":false,"f":[[["",{"children":["web3",{"children":["tools",{"children":["__PAGE__",{}]}]}]},"$undefined","$undefined",16],[["$","$1","c",{"children":[[["$","link","0",{"rel":"stylesheet","href":"/_next/static/chunks/09h7l4i38xc7q.css","precedence":"next","crossOrigin":"$undefined","nonce":"$undefined"}],["$","link","1",{"rel":"stylesheet","href":"/_next/static/chunks/0xdwau5k2augv.css","precedence":"next","crossOrigin":"$undefined","nonce":"$undefined"}],["$","script","script-0",{"src":"/_next/static/chunks/0ccalho416.d7.js","async":true,"nonce":"$undefined"}],["$","script","script-1",{"src":"/_next/static/chunks/14jhy~xia8lh8.js","async":true,"nonce":"$undefined"}],["$","script","script-2",{"src":"/_next/static/chunks/0t2xr05rlu96l.js","async":true,"nonce":"$undefined"}]],["$","html",null,{"lang":"zh-CN","suppressHydrationWarning":true,"data-scroll-behavior":"smooth","children":[["$","head",null,{"children":[["$","meta",null,{"charSet":"UTF-8"}],["$","meta",null,{"name":"viewport","content":"width=device-width, initial-scale=1.0"}],["$","link",null,{"rel":"icon","href":"/logo.svg","type":"image/svg+xml"}],["$","meta",null,{"name":"theme-color","content":"#5e6ad2"}],["$","script",null,{"dangerouslySetInnerHTML":{"__html":"\n              (function() {\n                var theme = localStorage.getItem('theme');\n                if (theme === 'dark' || (!theme && window.matchMedia('(prefers-color-scheme: dark)').matches)) {\n                  document.documentElement.setAttribute('data-theme', 'dark');\n                }\n              })();\n            "}}]]}],["$","body",null,{"children":["$","$L2",null,{"children":[["$","$L3",null,{}],["$","script",null,{"dangerouslySetInnerHTML":{"__html":"\n          window.onerror = function(message, source, lineno, colno, error) {\n            console.error('[Global Error]', { message, source, lineno, colno, error });\n          };\n          window.onunhandledrejection = function(event) {\n            console.error('[Unhandled Promise Rejection]', event.reason);\n          };\n        "}}],["$","$L4",null,{"parallelRouterKey":"children","error":"$undefined","errorStyles":"$undefined","errorScripts":"$undefined","template":["$","$L5",null,{}],"templateStyles":"$undefined","templateScripts":"$undefined","notFound":[["$","$L6",null,{}],[]],"forbidden":"$undefined","unauthorized":"$undefined"}]]}]}]]}]]}],{"children":[["$","$1","c",{"children":[[["$","link","0",{"rel":"stylesheet","href":"/_next/static/chunks/0ukyg~tkm~h2m.css","precedence":"next","crossOrigin":"$undefined","nonce":"$undefined"}]],["$","$L4",null,{"parallelRouterKey":"children","error":"$undefined","errorStyles":"$undefined","errorScripts":"$undefined","template":["$","$L5",null,{}],"templateStyles":"$undefined","templateScripts":"$undefined","notFound":"$undefined","forbidden":"$undefined","unauthorized":"$undefined"}]]}],{"children":[["$","$1","c",{"children":[null,["$","$L4",null,{"parallelRouterKey":"children","error":"$undefined","errorStyles":"$undefined","errorScripts":"$undefined","template":["$","$L5",null,{}],"templateStyles":"$undefined","templateScripts":"$undefined","notFound":"$undefined","forbidden":"$undefined","unauthorized":"$undefined"}]]}],{"children":[["$","$1","c",{"children":["$L7",null,["$","$L8",null,{"children":["$","$9",null,{"name":"Next.MetadataOutlet","children":"$@a"}]}]]}],{},null,false,null]},null,false,"$@b"]},null,false,null]},null,false,null],["$","$1","h",{"children":[null,["$","$Lc",null,{"children":"$Ld"}],["$","div",null,{"hidden":true,"children":["$","$Le",null,{"children":["$","$9",null,{"name":"Next.Metadata","children":"$Lf"}]}]}],null]}],false]],"m":"$undefined","G":["$10",[["$","link","0",{"rel":"stylesheet","href":"/_next/static/chunks/09h7l4i38xc7q.css","precedence":"next","crossOrigin":"$undefined","nonce":"$undefined"}],["$","link","1",{"rel":"stylesheet","href":"/_next/static/chunks/0xdwau5k2augv.css","precedence":"next","crossOrigin":"$undefined","nonce":"$undefined"}]]],"S":true,"h":null,"s":"$undefined","l":"$undefined","p":"$undefined","d":"$undefined","b":"2smv1H9Y4Z2Ri-SL-UFgR"}
 7:E{"digest":"NEXT_REDIRECT;replace;/web3;307;"}
 11:[]
 b:"$W11"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "most-box",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "MostBox - P2P file sharing application",
   "type": "module",
   "main": "electron/main.js",
@@ -17,9 +17,9 @@
   ],
   "scripts": {
     "start": "next dev",
+    "server": "node --watch server/index.js",
     "dev": "next dev",
     "build": "next build",
-    "server": "node --watch server/index.js",
     "serve": "next build && node server/index.js",
     "test": "node --test server/tests/**/*.test.js",
     "test:unit": "node --test server/tests/unit/*.test.js",
@@ -28,6 +28,7 @@
     "typecheck": "tsc --noEmit",
     "format": "npx prettier --write .",
     "lint": "npx eslint .",
+    "r2:cors": "node scripts/configure-r2-cors.mjs",
     "electron:dev": "concurrently \"npm run build\" \"wait-on out/index.html && electron .\"",
     "electron:rebuild": "electron-rebuild -f -w sodium-native",
     "electron:build": "npm run build && npm run electron:rebuild && electron-builder",
@@ -127,7 +128,7 @@
         "nsis"
       ],
       "artifactName": "${productName}-${version}-win-${arch}-setup.${ext}",
-      "icon": "public/favicon.ico"
+      "icon": "public/logo.ico"
     },
     "nsis": {
       "oneClick": false,
@@ -147,7 +148,7 @@
           ]
         }
       ],
-      "icon": "public/pwa-512x512.png",
+      "icon": "public/logo-512.png",
       "category": "public.app-category.utilities"
     },
     "dmg": {
@@ -175,7 +176,7 @@
           ]
         }
       ],
-      "icon": "public/pwa-512x512.png",
+      "icon": "public/logo-512.png",
       "category": "Utility"
     }
   }

package/public/logo.svg

@@ -0,0 +1,12 @@
+<svg
+  width="512"
+  height="512"
+  viewBox="0 0 24 24"
+  fill="none"
+  xmlns="http://www.w3.org/2000/svg"
+>
+  <rect x="2" y="2" width="8" height="8" rx="2" fill="#5e6ad2" opacity="0.4" />
+  <rect x="14" y="2" width="8" height="8" rx="2" fill="#5e6ad2" opacity="0.7" />
+  <rect x="2" y="14" width="8" height="8" rx="2" fill="#5e6ad2" opacity="0.7" />
+  <rect x="14" y="14" width="8" height="8" rx="2" fill="#5e6ad2" />
+</svg>

package/server/index.js

@@ -4,7 +4,6 @@ import { fileURLToPath } from 'node:url'
 import { WebSocketServer } from 'ws'
 import { serve } from '@hono/node-server'
 import { MostBoxEngine } from './src/index.js'
-import { createGanDengYanSocketHandlers } from './src/games/gandengyan.js'
 import {
   DEFAULT_NODE_HOST,
   DEFAULT_NODE_PORT,
@@ -133,13 +132,10 @@ function createWebSocketServer({
   cleanupWsSubscriptions,
 }) {
   const wss = new WebSocketServer({ noServer: true })
-  const ganDengYan = createGanDengYanSocketHandlers()
 
   wss.on('connection', ws => {
-    ganDengYan.bindClient(ws)
     ws.on('error', () => {})
     ws.on('close', () => {
-      ganDengYan.unbindClient(ws)
       cleanupWsSubscriptions(ws)
     })
     ws.on('message', raw => {
@@ -147,10 +143,6 @@ function createWebSocketServer({
         const msg = JSON.parse(raw)
         const { event, data } = msg
 
-        if (ganDengYan.handleMessage(ws, event, data)) {
-          return
-        }
-
         switch (event) {
           case 'register':
             ws.peerId = data.peerId

package/server/src/config.js

@@ -48,7 +48,7 @@ export const SWARM_BOOTSTRAP = [
 ]
 
 export const CHANNEL_NAME_MIN_LENGTH = 3
-export const CHANNEL_NAME_MAX_LENGTH = 20
+export const CHANNEL_NAME_MAX_LENGTH = 30
 export const CHANNEL_NAME_REGEX = /^[a-zA-Z0-9_-]+$/
 export const CHANNEL_NAME_PREFIX = 'most-box-room-'
 export const CHANNEL_MESSAGE_LIMIT = 100

package/server/src/core/gameRoom.js

@@ -0,0 +1,222 @@
+export const GAME_CHANNEL_TYPE = 'game'
+export const GAME_EVENT_KIND = 'mostbox.game.event'
+export const GAME_EVENT_VERSION = 1
+
+export const GAME_IDS = ['gandengyan', 'zhajinhua']
+
+const ROOM_CODE_ALPHABET = 'ABCDEFGHJKLMNPQRSTUVWXYZ23456789'
+
+export function normalizeGameId(input) {
+  const value = String(input || '').trim().toLowerCase()
+  return GAME_IDS.includes(value) ? value : ''
+}
+
+export function normalizeGameRoomCode(input) {
+  return String(input || '')
+    .trim()
+    .toUpperCase()
+    .replace(/[^A-Z0-9]/g, '')
+    .slice(0, 8)
+}
+
+export function isValidGameRoomCode(input) {
+  return /^[A-Z0-9]{4,8}$/.test(String(input || ''))
+}
+
+export function createGameRoomCode() {
+  let code = ''
+  for (let i = 0; i < 6; i++) {
+    code += ROOM_CODE_ALPHABET[randomInt(ROOM_CODE_ALPHABET.length)]
+  }
+  return code
+}
+
+export function gameRoomCodeToChannelName(gameId, roomCode) {
+  const normalizedGameId = normalizeGameId(gameId)
+  const code = normalizeGameRoomCode(roomCode)
+  if (!normalizedGameId || !isValidGameRoomCode(code)) return ''
+  return `game-${normalizedGameId}-${code.toLowerCase()}`
+}
+
+export function channelNameToGameRoom(input) {
+  const value = String(input || '').trim().toLowerCase()
+  const match = /^game-([a-z0-9]+)-([a-z0-9]+)$/.exec(value)
+  if (!match) return null
+  const gameId = normalizeGameId(match[1])
+  const roomCode = normalizeGameRoomCode(match[2])
+  if (!gameId || !isValidGameRoomCode(roomCode)) return null
+  return { gameId, roomCode }
+}
+
+export function createGameEvent({ gameId, roomCode, event, payload }) {
+  const normalizedGameId = normalizeGameId(gameId)
+  const code = normalizeGameRoomCode(roomCode)
+  return {
+    kind: GAME_EVENT_KIND,
+    version: GAME_EVENT_VERSION,
+    gameId: normalizedGameId,
+    roomCode: code,
+    event: String(event || ''),
+    eventId: createEventId(normalizedGameId || 'game'),
+    payload: payload || {},
+  }
+}
+
+export function parseGameEvent(content, options = {}) {
+  try {
+    const event = JSON.parse(String(content || ''))
+    if (
+      !event ||
+      event.kind !== GAME_EVENT_KIND ||
+      event.version !== GAME_EVENT_VERSION ||
+      typeof event.event !== 'string' ||
+      typeof event.eventId !== 'string'
+    ) {
+      return null
+    }
+
+    const gameId = normalizeGameId(event.gameId)
+    const roomCode = normalizeGameRoomCode(event.roomCode)
+    if (!gameId || !isValidGameRoomCode(roomCode)) return null
+    if (options.gameId && gameId !== normalizeGameId(options.gameId)) return null
+    if (
+      options.roomCode &&
+      roomCode !== normalizeGameRoomCode(options.roomCode)
+    ) {
+      return null
+    }
+
+    return {
+      ...event,
+      gameId,
+      roomCode,
+      payload:
+        event.payload && typeof event.payload === 'object'
+          ? event.payload
+          : {},
+    }
+  } catch {
+    return null
+  }
+}
+
+export function deriveGameRoomLobby(messages = [], options = {}) {
+  const players = []
+  const playerMap = new Map()
+  let hostAddress = ''
+
+  for (const message of sortMessages(messages)) {
+    const event = parseGameEvent(message.content, options)
+    if (!event) continue
+
+    if (event.event === 'room:create') {
+      const player = createPlayerFromPayload(event.payload?.player, message.author)
+      if (!player) continue
+      if (!hostAddress) hostAddress = player.address
+      upsertPlayer(players, playerMap, player)
+      continue
+    }
+
+    if (event.event === 'player:join') {
+      const player = createPlayerFromPayload(event.payload?.player, message.author)
+      if (player) upsertPlayer(players, playerMap, player)
+    }
+  }
+
+  return {
+    gameId: normalizeGameId(options.gameId),
+    roomCode: normalizeGameRoomCode(options.roomCode),
+    hostAddress,
+    players,
+  }
+}
+
+export function getLatestGameState(messages = [], options = {}) {
+  let latest = null
+  for (const message of sortMessages(messages)) {
+    const event = parseGameEvent(message.content, options)
+    if (!event) continue
+    if (event.event !== 'room:state') continue
+    const seq = Number(event.payload?.seq || 0)
+    if (!latest || seq >= Number(latest.payload?.seq || 0)) {
+      latest = event
+    }
+  }
+  return latest
+}
+
+export function createPlayerFromPayload(input, author) {
+  if (!input || typeof input !== 'object') return null
+  const address = normalizeAddress(input.address || author)
+  if (!address || normalizeAddress(author) !== address) return null
+  const name = String(input.name || '').trim().slice(0, 50) || shortAddress(address)
+  const publicKey = String(input.publicKey || '').trim()
+  return {
+    address,
+    name,
+    publicKey,
+    joinedAt: Number(input.joinedAt || Date.now()),
+  }
+}
+
+export function normalizeGamePlayer(input) {
+  if (!input || typeof input !== 'object') return null
+  const address = normalizeAddress(input.address)
+  if (!address) return null
+  return {
+    ...input,
+    address,
+    name: String(input.name || shortAddress(address)).slice(0, 50),
+    publicKey: String(input.publicKey || ''),
+  }
+}
+
+export function normalizeAddress(value) {
+  const address = String(value || '').trim()
+  return /^0x[a-fA-F0-9]{40}$/.test(address) ? address.toLowerCase() : ''
+}
+
+function upsertPlayer(players, playerMap, player) {
+  const existing = playerMap.get(player.address)
+  if (existing) {
+    Object.assign(existing, player)
+    return
+  }
+  players.push(player)
+  playerMap.set(player.address, player)
+}
+
+function sortMessages(messages) {
+  return [...messages].sort(
+    (a, b) => Number(a.timestamp || 0) - Number(b.timestamp || 0)
+  )
+}
+
+function createEventId(prefix) {
+  return `${prefix}_${Date.now()}_${randomHex(4)}`
+}
+
+function randomInt(max) {
+  if (globalThis.crypto?.getRandomValues) {
+    const value = new Uint32Array(1)
+    globalThis.crypto.getRandomValues(value)
+    return value[0] % max
+  }
+  return Math.floor(Math.random() * max)
+}
+
+function randomHex(byteLength) {
+  const bytes = new Uint8Array(byteLength)
+  if (globalThis.crypto?.getRandomValues) {
+    globalThis.crypto.getRandomValues(bytes)
+  } else {
+    for (let i = 0; i < bytes.length; i++) {
+      bytes[i] = Math.floor(Math.random() * 256)
+    }
+  }
+  return [...bytes].map(byte => byte.toString(16).padStart(2, '0')).join('')
+}
+
+function shortAddress(address) {
+  return address ? `${address.slice(0, 6)}...${address.slice(-4)}` : ''
+}