most-box 0.2.5 → 0.2.7

package/server/src/core/gameRoom.js

@@ -1,3 +1,15 @@
+import {
+  createEventId,
+  normalizeAddress,
+  normalizeAvatar,
+  normalizeDisplayName,
+  normalizeRoomCode,
+  randomInt,
+  shortAddress,
+} from './shared.js'
+
+export { normalizeAddress } from './shared.js'
+
 export const GAME_CHANNEL_TYPE = 'game'
 export const GAME_EVENT_KIND = 'mostbox.game.event'
 export const GAME_EVENT_VERSION = 1
@@ -12,11 +24,7 @@ export function normalizeGameId(input) {
 }
 
 export function normalizeGameRoomCode(input) {
-  return String(input || '')
-    .trim()
-    .toUpperCase()
-    .replace(/[^A-Z0-9]/g, '')
-    .slice(0, 8)
+  return normalizeRoomCode(input)
 }
 
 export function isValidGameRoomCode(input) {
@@ -166,10 +174,11 @@ export function createPlayerFromPayload(input, messageOrAuthor) {
   const author = message.author
   const address = normalizeAddress(input.address || author)
   if (!address || normalizeAddress(author) !== address) return null
-  const name =
-    String(message.authorName || input.name || '').trim().slice(0, 50) ||
+  const name = normalizeDisplayName(
+    message.authorName || input.name,
     shortAddress(address)
-  const avatar = String(message.avatar || input.avatar || '').trim()
+  )
+  const avatar = normalizeAvatar(message.avatar || input.avatar)
   const publicKey = String(input.publicKey || '').trim()
   const player = {
     address,
@@ -177,7 +186,7 @@ export function createPlayerFromPayload(input, messageOrAuthor) {
     publicKey,
     joinedAt: Number(input.joinedAt || Date.now()),
   }
-  if (avatar) player.avatar = avatar.slice(0, 4096)
+  if (avatar) player.avatar = avatar
   return player
 }
 
@@ -193,11 +202,6 @@ export function normalizeGamePlayer(input) {
   }
 }
 
-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) {
@@ -213,32 +217,3 @@ function sortMessages(messages) {
     (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)}` : ''
-}

package/server/src/core/ownerMetadata.js

@@ -1,9 +1,8 @@
+import { normalizeAddress } from './shared.js'
+
 export const DEFAULT_OWNER_BUCKET = '__local__'
 
-export function normalizeOwnerAddress(address) {
-  const value = String(address || '').trim()
-  return /^0x[a-fA-F0-9]{40}$/.test(value) ? value.toLowerCase() : ''
-}
+export const normalizeOwnerAddress = normalizeAddress
 
 export function getOwnerBucketKey(address) {
   return normalizeOwnerAddress(address) || DEFAULT_OWNER_BUCKET

package/server/src/core/releaseManifest.js

@@ -0,0 +1,108 @@
+export const RELEASE_PLATFORMS = ['windows', 'macos', 'linux']
+export const RELEASE_ARCHES = ['x64', 'arm64']
+export const RELEASE_ASSET_KINDS = ['installer', 'updater']
+
+export const RELEASE_TARGETS = Object.freeze([
+  { platform: 'windows', arch: 'x64' },
+  { platform: 'windows', arch: 'arm64' },
+  { platform: 'macos', arch: 'x64' },
+  { platform: 'macos', arch: 'arm64' },
+  { platform: 'linux', arch: 'x64' },
+  { platform: 'linux', arch: 'arm64' },
+])
+
+const RELEASE_PLATFORM_SET = new Set(RELEASE_PLATFORMS)
+const RELEASE_ARCH_SET = new Set(RELEASE_ARCHES)
+const RELEASE_ASSET_KIND_SET = new Set(RELEASE_ASSET_KINDS)
+
+function isRecord(value) {
+  return typeof value === 'object' && value !== null
+}
+
+function isNonEmptyString(value) {
+  return typeof value === 'string' && value.trim().length > 0
+}
+
+function isPositiveFiniteNumber(value) {
+  return Number.isFinite(value) && value > 0
+}
+
+function isOptionalNonEmptyString(value) {
+  return typeof value === 'undefined' || isNonEmptyString(value)
+}
+
+export function isReleaseAsset(value) {
+  if (!isRecord(value)) return false
+
+  return (
+    RELEASE_PLATFORM_SET.has(value.platform) &&
+    RELEASE_ARCH_SET.has(value.arch) &&
+    RELEASE_ASSET_KIND_SET.has(value.kind) &&
+    isNonEmptyString(value.filename) &&
+    isPositiveFiniteNumber(value.size) &&
+    isNonEmptyString(value.cid) &&
+    isNonEmptyString(value.githubUrl) &&
+    isOptionalNonEmptyString(value.r2Url)
+  )
+}
+
+export function isReleaseManifest(value) {
+  if (!isRecord(value)) return false
+  if (!isNonEmptyString(value.version)) return false
+  if (!isNonEmptyString(value.publishedAt)) return false
+  if (!Array.isArray(value.assets)) return false
+
+  return value.assets.every(isReleaseAsset)
+}
+
+export function getReleaseAssetKey(asset) {
+  return `${asset.platform}:${asset.arch}`
+}
+
+export function getInstallerReleaseAssets(manifest) {
+  if (!isReleaseManifest(manifest)) return []
+  return manifest.assets.filter(asset => asset.kind === 'installer')
+}
+
+export function hasR2ReleaseAssets(assets) {
+  if (!Array.isArray(assets)) return false
+  return assets.some(asset => isRecord(asset) && isNonEmptyString(asset.r2Url))
+}
+
+export function resolveReleaseAssetDownload(asset, preferredSource = 'r2') {
+  if (
+    preferredSource === 'r2' &&
+    isRecord(asset) &&
+    isNonEmptyString(asset.r2Url)
+  ) {
+    return {
+      source: 'r2',
+      url: asset.r2Url,
+    }
+  }
+
+  return {
+    source: 'github',
+    url:
+      isRecord(asset) && isNonEmptyString(asset.githubUrl)
+        ? asset.githubUrl
+        : '',
+  }
+}
+
+export function findCompatibleUpdateAsset(manifest, platform, arch) {
+  if (!isReleaseManifest(manifest)) return null
+
+  const compatibleAssets = manifest.assets.filter(
+    asset =>
+      asset.platform === platform &&
+      asset.arch === arch &&
+      (asset.kind === 'updater' || asset.kind === 'installer')
+  )
+
+  return (
+    compatibleAssets.find(asset => asset.kind === 'updater') ||
+    compatibleAssets.find(asset => asset.kind === 'installer') ||
+    null
+  )
+}

package/server/src/core/shared.js

@@ -0,0 +1,50 @@
+export function normalizeAddress(value) {
+  const address = String(value || '').trim()
+  return /^0x[a-fA-F0-9]{40}$/.test(address) ? address.toLowerCase() : ''
+}
+
+export function shortAddress(address) {
+  return address ? `${address.slice(0, 6)}...${address.slice(-4)}` : ''
+}
+
+export function normalizeAvatar(value) {
+  return String(value || '').trim().slice(0, 4096)
+}
+
+export function normalizeDisplayName(value, fallback = '', maxLength = 50) {
+  const displayName = String(value || '').trim()
+  return (displayName || String(fallback || '')).slice(0, maxLength)
+}
+
+export function normalizeRoomCode(value) {
+  return String(value || '')
+    .trim()
+    .toUpperCase()
+    .replace(/[^A-Z0-9]/g, '')
+    .slice(0, 8)
+}
+
+export function createEventId(prefix) {
+  return `${prefix}_${Date.now()}_${randomHex(4)}`
+}
+
+export 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)
+}
+
+export 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('')
+}

package/server/src/core/zhajinhua.js

@@ -1,3 +1,11 @@
+import {
+  createEventId as createSharedEventId,
+  normalizeAddress,
+  normalizeAvatar,
+  normalizeRoomCode as normalizeSharedRoomCode,
+  shortAddress,
+} from './shared.js'
+
 export const ZHJ_INITIAL_CHIPS = 1000
 export const ZHJ_ANTE = 10
 export const ZHJ_MIN_PLAYERS = 2
@@ -28,15 +36,11 @@ const CATEGORY_LABEL = {
 }
 
 export function normalizeRoomCode(input) {
-  return String(input || '')
-    .trim()
-    .toUpperCase()
-    .replace(/[^A-Z0-9]/g, '')
-    .slice(0, 8)
+  return normalizeSharedRoomCode(input)
 }
 
 export function createEventId(prefix = 'zhajinhua') {
-  return `${prefix}_${Date.now()}_${randomHex(4)}`
+  return createSharedEventId(prefix)
 }
 
 export function createRoundId() {
@@ -196,7 +200,7 @@ export function startRound({ roomCode, players, hostAddress, previousSeq = 0, pr
     return {
       address: player.address,
       name: player.name,
-      avatar: cleanAvatar(player.avatar),
+      avatar: normalizeAvatar(player.avatar),
       publicKey: player.publicKey,
       chips: Number(player.chips) - ZHJ_ANTE,
       status: 'active',
@@ -598,7 +602,7 @@ function normalizeRoundPlayer(input) {
   return {
     address,
     name: String(input.name || shortAddress(address)).slice(0, 50),
-    avatar: cleanAvatar(input.avatar),
+    avatar: normalizeAvatar(input.avatar),
     publicKey: String(input.publicKey || ''),
     chips: Math.max(0, Number(input.chips) || 0),
     status: input.status === 'folded' ? 'folded' : 'active',
@@ -607,31 +611,6 @@ function normalizeRoundPlayer(input) {
   }
 }
 
-function normalizeAddress(value) {
-  const address = String(value || '').trim()
-  return /^0x[a-fA-F0-9]{40}$/.test(address) ? address.toLowerCase() : ''
-}
-
-function shortAddress(address) {
-  return address ? `${address.slice(0, 6)}...${address.slice(-4)}` : ''
-}
-
-function cleanAvatar(value) {
-  return String(value || '').trim().slice(0, 4096)
-}
-
 function clone(value) {
   return JSON.parse(JSON.stringify(value))
 }
-
-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('')
-}

package/server/src/games/gandengyan.js

@@ -1,3 +1,5 @@
+import { normalizeAddress, normalizeAvatar } from '../core/shared.js'
+
 const SUITS = ['S', 'H', 'C', 'D']
 const RANKS = ['3', '4', '5', '6', '7', '8', '9', '10', 'J', 'Q', 'K', 'A', '2']
 const STRAIGHT_RANKS = RANKS.filter(rank => rank !== '2')
@@ -30,7 +32,7 @@ export function createGanDengYanRoom({
     players: roomPlayers.slice(0, 6).map((player, seat) => ({
       address: player.address,
       name: cleanName(player.name),
-      avatar: cleanAvatar(player.avatar),
+      avatar: normalizeAvatar(player.avatar),
       seat,
       hand: [],
       handCount: 0,
@@ -64,7 +66,7 @@ export function syncGanDengYanLobby(room, players = []) {
     .map((player, seat) => ({
       address: player.address,
       name: cleanName(player.name),
-      avatar: cleanAvatar(player.avatar),
+      avatar: normalizeAvatar(player.avatar),
       seat,
       hand: [],
       handCount: 0,
@@ -260,7 +262,7 @@ export function publicGanDengYanRoom(room) {
     players: orderedPlayers(room).map(player => ({
       address: player.address,
       name: player.name,
-      avatar: cleanAvatar(player.avatar),
+      avatar: normalizeAvatar(player.avatar),
       seat: player.seat,
       handCount: player.hand?.length ?? player.handCount ?? 0,
       score: Number(player.score ?? INITIAL_SCORE),
@@ -435,7 +437,7 @@ function normalizePlayers(players) {
     .map(player => ({
       address: normalizeAddress(player.address),
       name: cleanName(player.name),
-      avatar: cleanAvatar(player.avatar),
+      avatar: normalizeAvatar(player.avatar),
       publicKey: String(player.publicKey || ''),
     }))
     .filter(player => {
@@ -451,7 +453,7 @@ function normalizeRoundPlayer(input) {
   return {
     address,
     name: cleanName(input.name),
-    avatar: cleanAvatar(input.avatar),
+    avatar: normalizeAvatar(input.avatar),
     seat: Number(input.seat || 0),
     hand: Array.isArray(input.hand) ? input.hand.map(normalizeCard).filter(Boolean) : [],
     handCount: Number(input.handCount || 0),
@@ -677,15 +679,6 @@ function rollDice(random) {
   return Math.floor(random() * 6) + 1
 }
 
-function normalizeAddress(value) {
-  const address = String(value || '').trim()
-  return /^0x[a-fA-F0-9]{40}$/.test(address) ? address.toLowerCase() : ''
-}
-
 function cleanName(name) {
   return String(name || '玩家').trim().slice(0, 16) || '玩家'
 }
-
-function cleanAvatar(avatar) {
-  return String(avatar || '').trim().slice(0, 4096)
-}

package/server/src/http/nodeStatus.js

@@ -260,12 +260,6 @@ export function buildOpenApiSpec(appPort) {
           responses: { 200: { description: 'Created channel message' } },
         },
       },
-      '/api/channels/{name}/members': {
-        get: {
-          summary: 'List P2P channel members',
-          responses: { 200: { description: 'Channel members' } },
-        },
-      },
       '/api/channels/{name}/peers': {
         get: {
           summary: 'List currently connected channel peers',

package/server/src/http/routes/channelRoutes.js

@@ -1,4 +1,4 @@
-import { normalizeAddress } from '../../utils/auth.js'
+import { normalizeAddress } from '../../core/shared.js'
 import { badRequestOrAppError } from '../errors.js'
 
 export function registerChannelRoutes(app, { engine }) {
@@ -72,18 +72,6 @@ export function registerChannelRoutes(app, { engine }) {
     }
   })
 
-  app.get('/api/channels/:name/members', c => {
-    try {
-      return c.json(
-        engine.getChannelMembers(c.req.param('name'), {
-          ownerAddress: c.get('userAddress'),
-        })
-      )
-    } catch (err) {
-      return badRequestOrAppError(c, err)
-    }
-  })
-
   app.post('/api/channels/:name/messages', async c => {
     const name = c.req.param('name')
     const body = await c.req.json()

package/server/src/http/routes/nodeRoutes.js

@@ -1,4 +1,4 @@
-import { normalizeAddress } from '../../utils/auth.js'
+import { normalizeAddress } from '../../core/shared.js'
 import { evaluateStorageLimits } from '../../node/config.js'
 import {
   isLoopbackRemoteAddress,

package/server/src/index.js

@@ -93,6 +93,7 @@ import {
 } from './config.js'
 
 const sleep = ms => new Promise(resolve => setTimeout(resolve, ms))
+const CHANNEL_WELCOME_MESSAGE = '我加入了群聊'
 
 function createMemoryDuplexPair() {
   let left
@@ -2462,6 +2463,7 @@ export class MostBoxEngine extends EventEmitter {
           channel => channel.channelKey === candidate.channelKey
         )
         if (existing) {
+          const wasMember = this.#channelHasMember(existing, ownerAddress)
           const writerKeysChanged = await this.#mergeChannelWriterCoreKeys(
             existing,
             candidate.writerCoreKeys
@@ -2472,6 +2474,7 @@ export class MostBoxEngine extends EventEmitter {
             this.#saveChannelsMetadata()
             this.#broadcastChannelHello()
           }
+          await this.#appendChannelWelcomeMessage(existing, options, wasMember)
           return this.#formatChannelForResponse(existing, ownerAddress)
         }
         const joined = await this.#joinChannelFromCandidate(
@@ -2528,6 +2531,7 @@ export class MostBoxEngine extends EventEmitter {
     const channelKey = buildChannelKey(channelId)
     const existing = this.#channels.find(c => c.channelKey === channelKey)
     if (existing) {
+      const wasMember = this.#channelHasMember(existing, options.ownerAddress)
       const writerKeysChanged = await this.#mergeChannelWriterCoreKeys(
         existing,
         candidate.writerCoreKeys
@@ -2538,6 +2542,7 @@ export class MostBoxEngine extends EventEmitter {
         this.#saveChannelsMetadata()
         this.#broadcastChannelHello()
       }
+      await this.#appendChannelWelcomeMessage(existing, options, wasMember)
       return this.#formatChannelForResponse(existing, options.ownerAddress)
     }
 
@@ -2730,14 +2735,6 @@ export class MostBoxEngine extends EventEmitter {
       .map(c => this.#formatChannelForResponse(c, ownerAddress))
   }
 
-  getChannelMembers(channelKeyInput, options = {}) {
-    this.#ensureInitialized()
-    this.#assertChannelMember(channelKeyInput, options.ownerAddress)
-    const channel = this.#resolveChannel(channelKeyInput, options.ownerAddress)
-
-    return this.#getChannelMembers(channel)
-  }
-
   /**
    * 获取频道消息
    * @param {string} channelKeyInput - 内部频道 key，或本地唯一短频道 ID
@@ -2843,15 +2840,22 @@ export class MostBoxEngine extends EventEmitter {
       this.#saveChannelsMetadata()
     }
 
+    const normalizedAvatar = normalizeChannelAvatar(options.avatar)
     const message = {
       type: 'message',
       author,
-      authorName,
+      authorName: normalizeChannelDisplayName(
+        authorName,
+        normalizeOwnerAddress(author)
+      ),
       content: trimmed,
       timestamp: await this.#getNextChannelMessageTimestamp(
         channel.channelKey
       ),
     }
+    if (normalizedAvatar) {
+      message.avatar = normalizedAvatar
+    }
     if (attachment) {
       message.attachment = attachment
     }
@@ -2977,6 +2981,7 @@ export class MostBoxEngine extends EventEmitter {
     await this.#joinChannelDiscoveryTopics(channelInfo)
     this.#cacheChannelCandidate(this.#channelToCandidate(channelInfo, true))
     this.#saveChannelsMetadata()
+    await this.#appendChannelWelcomeMessage(channelInfo, options, false)
     this.#broadcastChannelHello()
     return channelInfo
   }
@@ -2994,10 +2999,12 @@ export class MostBoxEngine extends EventEmitter {
       channel => channel.channelKey === channelKey
     )
     if (existing) {
+      const wasMember = this.#channelHasMember(existing, options.ownerAddress)
       if (this.#upsertChannelMember(existing, options)) {
         this.#saveChannelsMetadata()
         this.#broadcastChannelHello()
       }
+      await this.#appendChannelWelcomeMessage(existing, options, wasMember)
       return this.#formatChannelForResponse(existing, options.ownerAddress)
     }
 
@@ -3328,6 +3335,32 @@ export class MostBoxEngine extends EventEmitter {
     return true
   }
 
+  async #appendChannelWelcomeMessage(channel, options = {}, wasMember = false) {
+    const ownerAddress = normalizeOwnerAddress(options.ownerAddress)
+    if (
+      wasMember ||
+      !ownerAddress ||
+      !channel ||
+      TRANSIENT_CHANNEL_TYPES.has(channel.type)
+    ) {
+      return false
+    }
+
+    await this.sendMessage(
+      channel.channelKey,
+      CHANNEL_WELCOME_MESSAGE,
+      ownerAddress,
+      normalizeChannelDisplayName(options.displayName, ownerAddress),
+      {
+        ownerAddress,
+        ...(Object.prototype.hasOwnProperty.call(options, 'avatar')
+          ? { avatar: options.avatar }
+          : {}),
+      }
+    )
+    return true
+  }
+
   #getChannelMembers(channel) {
     const members = Array.isArray(channel?.members) ? channel.members : []
     return members
@@ -3392,14 +3425,11 @@ export class MostBoxEngine extends EventEmitter {
         authorAddress
       )
       const avatar = normalizeChannelAvatar(member.avatar)
-      if (displayName && baseMessage?.authorName !== displayName) {
+      if (displayName && !String(baseMessage?.authorName || '').trim()) {
         baseMessage = { ...baseMessage, authorName: displayName }
       }
-      if (avatar && baseMessage?.avatar !== avatar) {
+      if (avatar && !normalizeChannelAvatar(baseMessage?.avatar)) {
         baseMessage = { ...baseMessage, avatar }
-      } else if (!avatar && baseMessage?.avatar) {
-        baseMessage = { ...baseMessage }
-        delete baseMessage.avatar
       }
     }
     const attachment = baseMessage?.attachment

package/server/src/utils/api.js

@@ -164,6 +164,49 @@ function clearActiveRemoteNode() {
   )
 }
 
+function getLocalNodeHistoryItem(activeBackendUrl = getBackendUrl()) {
+  const normalizedActiveUrl = normalizeBackendUrl(activeBackendUrl)
+  const fallbackLocalUrl = getDefaultBackendUrl()
+  const localUrl = isLocalBackendUrl(normalizedActiveUrl)
+    ? normalizedActiveUrl
+    : fallbackLocalUrl
+
+  if (!isLocalBackendUrl(localUrl)) return null
+
+  const url = normalizeBackendUrl(localUrl)
+  return {
+    url,
+    invite: '',
+    active: url === normalizedActiveUrl,
+    local: true,
+    updatedAt: Number.MAX_SAFE_INTEGER,
+  }
+}
+
+function getNodeHistory() {
+  if (typeof window === 'undefined') return []
+
+  const activeBackendUrl = normalizeBackendUrl(getBackendUrl())
+  const localNode = getLocalNodeHistoryItem(activeBackendUrl)
+  const remoteNodes = getRemoteNodes().map((node, index) => ({
+    ...node,
+    active: normalizeBackendUrl(node.url) === activeBackendUrl,
+    local: false,
+    order: index + 1,
+  }))
+  const nodes = localNode
+    ? [{ ...localNode, order: 0 }, ...remoteNodes]
+    : remoteNodes
+
+  return nodes
+    .sort((a, b) => {
+      if (a.active !== b.active) return a.active ? -1 : 1
+      if (a.local !== b.local) return a.local ? -1 : 1
+      return a.order - b.order
+    })
+    .map(({ order: _order, ...node }) => node)
+}
+
 function normalizeBackendUrl(url) {
   return (url || '').trim().replace(/\/+$/, '')
 }
@@ -390,6 +433,10 @@ export function getRemoteNodesExport() {
   return getRemoteNodes()
 }
 
+export function getNodeHistoryExport() {
+  return getNodeHistory()
+}
+
 export function getBackendInviteExport() {
   return getBackendInvite()
 }

package/server/src/utils/auth.js

@@ -1,12 +1,9 @@
 import { verifyMessage } from 'ethers'
+import { normalizeAddress } from '../core/shared.js'
 import { mostSignMessage } from './mostWallet.js'
 
 export const AUTH_MAX_AGE_MS = 5 * 60 * 1000
-
-export function normalizeAddress(address) {
-  const value = String(address || '').trim()
-  return /^0x[a-fA-F0-9]{40}$/.test(value) ? value.toLowerCase() : ''
-}
+export { normalizeAddress }
 
 export function buildAuthMessage(timestamp, method, path) {
   return `${timestamp}:${String(method || 'GET').toUpperCase()}:${normalizeAuthPath(path)}`