@@ -319,6 +431,34 @@ export default function FullTextSearchByRelay({
) : null}
+ {archivesRow ? (
+
+
+
+ {t('Full-text search source archives')}
+
+ 0
+ ? 'text-foreground'
+ : 'text-muted-foreground'
+ )}
+ >
+ {formatLocalStatusLabel(archivesRow, t)}
+ {archivesRow.ms != null && archivesRow.phase !== 'loading' ? (
+ · {archivesRow.ms} ms
+ ) : null}
+
+ {archivesRow.phase === 'loading' ? (
+
+ ) : null}
+
+ ) : null}
) : null}
@@ -340,16 +480,26 @@ export default function FullTextSearchByRelay({
>
{t('Full-text search seen on label')}
- {t('Full-text search local archive badge')}
+ {hit.source === 'archives'
+ ? t('Full-text search archives badge')
+ : t('Full-text search local archive badge')}
{
try {
+ if (!skipShortcuts) {
+ const fromLocal = await resolveThreadContextEventFromLocalStores(
+ eventId,
+ initialMatches ? initialEvent : undefined
+ )
+ if (cancelled) return
+ if (fromLocal && !isEventDeleted(fromLocal)) {
+ setEvent(fromLocal)
+ addReplies([fromLocal])
+ setIsFetching(false)
+ return
+ }
+ // Archives REST is already tried inside resolveThreadContextEventFromLocalStores.
+ }
+
// First load: DataLoader dedupes. Refetches (incl. session-waiter) clear a prior undefined so
// timeline-cached events resolve after the embed mounted first.
const opts = fetchOpts?.relayHints?.length ? fetchOpts : undefined
diff --git a/src/hooks/useNostrArchivesSocial.ts b/src/hooks/useNostrArchivesSocial.ts
new file mode 100644
index 00000000..a76e74b8
--- /dev/null
+++ b/src/hooks/useNostrArchivesSocial.ts
@@ -0,0 +1,40 @@
+import { useNostrArchivesAvailable } from '@/hooks/useNostrArchivesAvailable'
+import nostrArchivesApi from '@/services/nostr-archives-api.service'
+import { useEffect, useState } from 'react'
+
+export function useNostrArchivesSocial(pubkey?: string | null, refreshNonce = 0) {
+ const archivesAvailable = useNostrArchivesAvailable()
+ const [followersCount, setFollowersCount] = useState(null)
+ const [isFetching, setIsFetching] = useState(false)
+
+ useEffect(() => {
+ let cancelled = false
+
+ if (!pubkey?.trim() || !archivesAvailable) {
+ setFollowersCount(null)
+ setIsFetching(false)
+ return
+ }
+
+ setIsFetching(true)
+ void nostrArchivesApi
+ .getSocialGraph(pubkey, { followsLimit: 0, followersLimit: 0 })
+ .then((res) => {
+ if (cancelled) return
+ setFollowersCount(res.ok ? res.data.followers.count : null)
+ })
+ .finally(() => {
+ if (!cancelled) setIsFetching(false)
+ })
+
+ return () => {
+ cancelled = true
+ }
+ }, [pubkey, refreshNonce, archivesAvailable])
+
+ return {
+ followersCount,
+ isFetching,
+ showFollowers: archivesAvailable && followersCount != null
+ }
+}
diff --git a/src/i18n/locales/de.ts b/src/i18n/locales/de.ts
index e17c68d6..668b38fa 100644
--- a/src/i18n/locales/de.ts
+++ b/src/i18n/locales/de.ts
@@ -27,6 +27,7 @@ export default {
Profile: 'Profil',
Logout: 'Abmelden',
Following: 'Folgende',
+ Followers: 'Follower',
followings: 'Folgekonten',
boosted: 'geboostet',
'Boosted by:': 'Geboostet von:',
@@ -108,6 +109,13 @@ export default {
Note: 'Notiz',
note: 'notiz',
"username's following": '{{username}}s Folgen',
+ "username's followers": '{{username}}s Follower',
+ 'Nostr Archives followers hint': 'Followerzahl und Liste von Nostr Archives (Indexer).',
+ 'Use Nostr Archives API': 'Nostr Archives API nutzen',
+ 'Use Nostr Archives API hint':
+ 'Indexer für Suche, Follower, Notiz-Statistiken und schnellere Notiz-Ladung. Aus = nur Relays.',
+ 'Followers list unavailable': 'Followerliste ist gerade nicht verfügbar.',
+ 'No followers found': 'Keine Follower gefunden.',
"username's used relays": '{{username}}s verwendete Relays',
"username's muted": '{{username}}s stummgeschaltet',
Login: 'Anmelden',
@@ -2445,6 +2453,10 @@ export default {
'Full-text search all relays finished': 'All relay queries have finished.',
'Full-text search sources progress': 'Suchquellen',
'Full-text search source local': 'Dieses Gerät',
+ 'Full-text search source archives': 'Nostr Archives',
+ 'Full-text search archives unavailable': 'Nicht verfügbar',
+ 'Full-text search archives badge': 'Archives',
+ 'Full-text search archives description': 'Vom Nostr-Archives-Indexer',
'Full-text search source loading': 'Suche läuft…',
'Full-text search source zero hits': '0 Treffer',
'Full-text search source zero with note': '0 Treffer · {{note}}',
diff --git a/src/i18n/locales/en.ts b/src/i18n/locales/en.ts
index 76a7173c..e1a5ca55 100644
--- a/src/i18n/locales/en.ts
+++ b/src/i18n/locales/en.ts
@@ -27,6 +27,7 @@ export default {
Profile: 'Profile',
Logout: 'Logout',
Following: 'Following',
+ Followers: 'Followers',
followings: 'followings',
boosted: 'boosted',
'Boosted by:': 'Boosted by:',
@@ -107,6 +108,13 @@ export default {
Note: 'Note',
note: 'note',
"username's following": "{{username}}'s following",
+ "username's followers": "{{username}}'s followers",
+ 'Nostr Archives followers hint': 'Follower count and list from Nostr Archives (indexer).',
+ 'Use Nostr Archives API': 'Use Nostr Archives API',
+ 'Use Nostr Archives API hint':
+ 'Indexer for search, followers, note stats, and faster note loads. Turn off to use relays only.',
+ 'Followers list unavailable': 'Followers list is unavailable right now.',
+ 'No followers found': 'No followers found.',
"username's used relays": "{{username}}'s used relays",
"username's muted": "{{username}}'s muted",
Login: 'Login',
@@ -2458,6 +2466,10 @@ export default {
'Full-text search all relays finished': 'All relay queries have finished.',
'Full-text search sources progress': 'Search sources',
'Full-text search source local': 'This device',
+ 'Full-text search source archives': 'Nostr Archives',
+ 'Full-text search archives unavailable': 'Unavailable',
+ 'Full-text search archives badge': 'Archives',
+ 'Full-text search archives description': 'From Nostr Archives indexer',
'Full-text search source loading': 'Searching…',
'Full-text search source zero hits': '0 hits',
'Full-text search source zero with note': '0 hits · {{note}}',
diff --git a/src/lib/archives-profile-metadata.ts b/src/lib/archives-profile-metadata.ts
new file mode 100644
index 00000000..67513b53
--- /dev/null
+++ b/src/lib/archives-profile-metadata.ts
@@ -0,0 +1,38 @@
+import { formatPubkey, pubkeyToNpub } from '@/lib/pubkey'
+import type { TProfile } from '@/types'
+import type { TArchivesProfileMetadata } from '@/types/nostr-archives'
+
+/** Map Nostr Archives profile metadata to {@link TProfile} for search / list UI. */
+export function archivesMetadataToProfile(meta: TArchivesProfileMetadata): TProfile | null {
+ const pk = meta.pubkey?.trim().toLowerCase()
+ if (!pk || !/^[0-9a-f]{64}$/.test(pk)) return null
+
+ const npub = pubkeyToNpub(pk) ?? ''
+ const username =
+ meta.display_name?.trim() ||
+ meta.preferred_name?.trim() ||
+ meta.name?.trim() ||
+ formatPubkey(pk)
+
+ return {
+ pubkey: pk,
+ npub,
+ username,
+ avatar: meta.picture?.trim() || undefined,
+ about: meta.about?.trim() || undefined,
+ nip05: meta.nip05?.trim() || undefined,
+ lud16: meta.lud16?.trim() || undefined
+ }
+}
+
+export function archivesMetadataListToProfiles(metas: readonly TArchivesProfileMetadata[]): TProfile[] {
+ const out: TProfile[] = []
+ const seen = new Set()
+ for (const meta of metas) {
+ const p = archivesMetadataToProfile(meta)
+ if (!p || seen.has(p.pubkey)) continue
+ seen.add(p.pubkey)
+ out.push(p)
+ }
+ return out
+}
diff --git a/src/lib/document-meta.ts b/src/lib/document-meta.ts
index e9bcdb5f..29677394 100644
--- a/src/lib/document-meta.ts
+++ b/src/lib/document-meta.ts
@@ -211,6 +211,10 @@ export function resolveImwaldRouteSocialCopy(
pageTitle = `Following · ${SITE_NAME}`
ogTitle = `Following list · ${SITE_NAME}`
description = `Following list on ${SITE_NAME}.`
+ } else if (path.match(/^\/users\/[^/]+\/followers$/)) {
+ pageTitle = `Followers · ${SITE_NAME}`
+ ogTitle = `Followers list · ${SITE_NAME}`
+ description = `Followers list on ${SITE_NAME}.`
} else if (path.match(/^\/users\/[^/]+\/relays$/)) {
pageTitle = `Relays · ${SITE_NAME}`
ogTitle = `User relays · ${SITE_NAME}`
diff --git a/src/lib/link.ts b/src/lib/link.ts
index d47cfc2b..ef90227b 100644
--- a/src/lib/link.ts
+++ b/src/lib/link.ts
@@ -105,6 +105,10 @@ export const toFollowingList = (pubkey: string) => {
const npub = nip19.npubEncode(pubkey)
return `/users/${npub}/following`
}
+export const toFollowersList = (pubkey: string) => {
+ const npub = nip19.npubEncode(pubkey)
+ return `/users/${npub}/followers`
+}
export const toOthersRelaySettings = (pubkey: string) => {
const npub = nip19.npubEncode(pubkey)
return `/users/${npub}/relays`
diff --git a/src/lib/nostr-archives-event.test.ts b/src/lib/nostr-archives-event.test.ts
new file mode 100644
index 00000000..03c96d04
--- /dev/null
+++ b/src/lib/nostr-archives-event.test.ts
@@ -0,0 +1,69 @@
+import { describe, expect, it } from 'vitest'
+import {
+ archivesJsonToVerifiedEvent,
+ isPersistableNostrEventShape,
+ stripArchivesEngagementFields
+} from '@/lib/nostr-archives-event'
+import type { Event } from 'nostr-tools'
+
+describe('stripArchivesEngagementFields', () => {
+ it('removes engagement fields but keeps nested event wrapper', () => {
+ const inner = {
+ id: 'a'.repeat(64),
+ pubkey: 'b'.repeat(64),
+ kind: 1,
+ content: 'hi',
+ created_at: 1,
+ tags: [],
+ sig: 'c'.repeat(128)
+ }
+ const raw = {
+ event: inner,
+ reactions: 5,
+ replies: 2,
+ reposts: 1,
+ zap_sats: 100
+ }
+ const stripped = stripArchivesEngagementFields(raw)
+ expect(stripped.event).toEqual(inner)
+ expect(stripped).not.toHaveProperty('reactions')
+ expect(stripped).not.toHaveProperty('replies')
+ expect(stripped).not.toHaveProperty('reposts')
+ expect(stripped).not.toHaveProperty('zap_sats')
+ })
+})
+
+describe('isPersistableNostrEventShape', () => {
+ const base = {
+ id: 'a'.repeat(64),
+ pubkey: 'b'.repeat(64),
+ kind: 1,
+ content: 'hi',
+ created_at: 1700000000,
+ tags: [] as string[][],
+ sig: 'c'.repeat(128)
+ } as Event
+
+ it('rejects NaN kind', () => {
+ expect(isPersistableNostrEventShape({ ...base, kind: NaN })).toBe(false)
+ })
+
+ it('rejects NaN created_at', () => {
+ expect(isPersistableNostrEventShape({ ...base, created_at: NaN })).toBe(false)
+ })
+})
+
+describe('archivesJsonToVerifiedEvent', () => {
+ it('returns null when kind is missing and coerces to NaN', () => {
+ expect(
+ archivesJsonToVerifiedEvent({
+ id: 'a'.repeat(64),
+ pubkey: 'b'.repeat(64),
+ content: 'hi',
+ created_at: 1700000000,
+ tags: [],
+ sig: 'c'.repeat(128)
+ })
+ ).toBeNull()
+ })
+})
diff --git a/src/lib/nostr-archives-event.ts b/src/lib/nostr-archives-event.ts
index 5ddc8720..4ac7e953 100644
--- a/src/lib/nostr-archives-event.ts
+++ b/src/lib/nostr-archives-event.ts
@@ -2,6 +2,7 @@ import logger from '@/lib/logger'
import type { Event } from 'nostr-tools'
import { validateEvent, verifyEvent } from 'nostr-tools'
+/** Engagement / aggregate fields on API rows — not Nostr event fields. */
const ARCHIVES_ENGAGEMENT_KEYS = new Set([
'reactions',
'replies',
@@ -10,8 +11,8 @@ const ARCHIVES_ENGAGEMENT_KEYS = new Set([
'count',
'total_sats',
'amount_sats',
- 'event',
'profiles'
+ // `event` is a structural wrapper ({ event, reactions, … }), not enrichment — do not strip.
])
/** Strip Archives enrichment fields before treating a row as a Nostr event. */
@@ -26,7 +27,7 @@ export function stripArchivesEngagementFields(raw: Record): Rec
export function isPersistableNostrEventShape(ev: Event): boolean {
if (!/^[0-9a-f]{64}$/i.test(ev.id)) return false
if (!/^[0-9a-f]{64}$/i.test(ev.pubkey)) return false
- if (typeof ev.kind !== 'number' || !Number.isFinite(ev.created_at)) return false
+ if (!Number.isFinite(ev.kind) || !Number.isFinite(ev.created_at)) return false
if (typeof ev.content !== 'string') return false
if (typeof ev.sig !== 'string' || ev.sig.length < 64) return false
if (!Array.isArray(ev.tags)) return false
@@ -47,6 +48,7 @@ export function archivesJsonToVerifiedEvent(raw: unknown): Event | null {
const pubkey = typeof base.pubkey === 'string' ? base.pubkey.toLowerCase() : ''
const kind = typeof base.kind === 'number' ? base.kind : Number(base.kind)
const created_at = typeof base.created_at === 'number' ? base.created_at : Number(base.created_at)
+ if (!Number.isFinite(kind) || !Number.isFinite(created_at)) return null
const content = typeof base.content === 'string' ? base.content : ''
const sig = typeof base.sig === 'string' ? base.sig : ''
const tags = Array.isArray(base.tags) ? (base.tags as Event['tags']) : []
diff --git a/src/lib/nostr-archives-search-resolved.test.ts b/src/lib/nostr-archives-search-resolved.test.ts
new file mode 100644
index 00000000..e85244e5
--- /dev/null
+++ b/src/lib/nostr-archives-search-resolved.test.ts
@@ -0,0 +1,26 @@
+import { describe, expect, it } from 'vitest'
+import { archivesSearchResolvedToParams } from './nostr-archives-search-resolved'
+import { nip19 } from 'nostr-tools'
+
+const TEST_HEX = '3bf0d63a9344db8bd60b9072ff3e50b9a6662a93f2a4b9a86dd19e4559c94512'
+
+describe('archivesSearchResolvedToParams', () => {
+ it('maps profile type + hex pubkey', () => {
+ const params = archivesSearchResolvedToParams({ type: 'profile', pubkey: TEST_HEX })
+ expect(params?.type).toBe('profile')
+ expect(params?.search).toBe(nip19.npubEncode(TEST_HEX))
+ })
+
+ it('maps note type + hex id', () => {
+ const params = archivesSearchResolvedToParams({ type: 'note', id: TEST_HEX })
+ expect(params?.type).toBe('note')
+ expect(params?.search).toBe(TEST_HEX)
+ })
+
+ it('maps bech32 string resolved payload', () => {
+ const npub = nip19.npubEncode(TEST_HEX)
+ const params = archivesSearchResolvedToParams(npub)
+ expect(params?.type).toBe('profile')
+ expect(params?.search).toBe(npub)
+ })
+})
diff --git a/src/lib/nostr-archives-search-resolved.ts b/src/lib/nostr-archives-search-resolved.ts
new file mode 100644
index 00000000..627f03ef
--- /dev/null
+++ b/src/lib/nostr-archives-search-resolved.ts
@@ -0,0 +1,137 @@
+import nostrArchivesApi from '@/services/nostr-archives-api.service'
+import type { TSearchParams } from '@/types'
+import { nip19 } from 'nostr-tools'
+
+function decodeNip19Id(raw: string): TSearchParams | null {
+ let id = raw.trim()
+ if (!id) return null
+ if (id.startsWith('nostr:')) id = id.slice(6)
+ try {
+ const { type } = nip19.decode(id)
+ if (type === 'npub' || type === 'nprofile') {
+ return { type: 'profile', search: id }
+ }
+ if (type === 'nevent' || type === 'naddr' || type === 'note') {
+ return { type: 'note', search: id }
+ }
+ } catch {
+ // not bech32
+ }
+ return null
+}
+
+/** Map Archives `GET /v1/search` `resolved` payload to in-app search navigation. */
+export function archivesSearchResolvedToParams(
+ resolved: unknown,
+ fallbackQuery?: string
+): TSearchParams | null {
+ if (resolved == null) return null
+
+ if (typeof resolved === 'string') {
+ const trimmed = resolved.trim()
+ const fromBech32 = decodeNip19Id(trimmed)
+ if (fromBech32) return fromBech32
+ if (/^[0-9a-f]{64}$/i.test(trimmed)) {
+ return { type: 'note', search: trimmed.toLowerCase() }
+ }
+ return null
+ }
+
+ if (typeof resolved !== 'object') return null
+ const o = resolved as Record
+
+ const typeRaw = String(o.type ?? o.kind ?? o.entity_type ?? '').toLowerCase()
+ const idRaw = String(
+ o.id ?? o.identifier ?? o.ref ?? o.bech32 ?? o.npub ?? o.note_id ?? o.event_id ?? ''
+ ).trim()
+
+ if (typeRaw === 'profile' || typeRaw === 'npub' || typeRaw === 'nprofile' || typeRaw === '0') {
+ const pubkey = String(o.pubkey ?? o.author ?? idRaw).trim()
+ if (/^[0-9a-f]{64}$/i.test(pubkey)) {
+ try {
+ return { type: 'profile', search: nip19.npubEncode(pubkey) }
+ } catch {
+ return { type: 'profile', search: pubkey.toLowerCase() }
+ }
+ }
+ const fromBech32 = decodeNip19Id(idRaw || pubkey)
+ if (fromBech32?.type === 'profile') return fromBech32
+ }
+
+ if (
+ typeRaw === 'note' ||
+ typeRaw === 'event' ||
+ typeRaw === 'nevent' ||
+ typeRaw === 'naddr' ||
+ typeRaw === 'note1' ||
+ typeRaw === '1'
+ ) {
+ if (/^[0-9a-f]{64}$/i.test(idRaw)) {
+ return { type: 'note', search: idRaw.toLowerCase() }
+ }
+ const fromBech32 = decodeNip19Id(idRaw)
+ if (fromBech32?.type === 'note') return fromBech32
+ }
+
+ const embedded = o.event
+ if (embedded && typeof embedded === 'object') {
+ const ev = embedded as Record
+ const evId = String(ev.id ?? '').trim()
+ if (/^[0-9a-f]{64}$/i.test(evId)) {
+ return { type: 'note', search: evId.toLowerCase() }
+ }
+ }
+
+ const pubkeyOnly = String(o.pubkey ?? '').trim()
+ if (/^[0-9a-f]{64}$/i.test(pubkeyOnly)) {
+ try {
+ return { type: 'profile', search: nip19.npubEncode(pubkeyOnly) }
+ } catch {
+ return { type: 'profile', search: pubkeyOnly.toLowerCase() }
+ }
+ }
+
+ if (idRaw) {
+ const fromBech32 = decodeNip19Id(idRaw)
+ if (fromBech32) return fromBech32
+ if (/^[0-9a-f]{64}$/i.test(idRaw)) {
+ return { type: 'note', search: idRaw.toLowerCase() }
+ }
+ }
+
+ if (fallbackQuery) {
+ const q = fallbackQuery.trim()
+ const fromBech32 = decodeNip19Id(q)
+ if (fromBech32) return fromBech32
+ if (/^[0-9a-f]{64}$/i.test(q)) {
+ return { type: 'note', search: q.toLowerCase() }
+ }
+ }
+
+ return null
+}
+
+/** When Archives resolves a Nostr entity, returns direct navigation params (or null). */
+export async function tryResolveSearchViaArchives(query: string): Promise {
+ const q = query.trim()
+ if (!q || !nostrArchivesApi.isAvailable()) return null
+
+ const res = await nostrArchivesApi.searchGeneral({ q, type: 'all', limit: 1 })
+ if (!res.ok || res.data.resolved == null) return null
+
+ return archivesSearchResolvedToParams(res.data.resolved, q)
+}
+
+export function isAmbiguousHexSearchQuery(query: string): boolean {
+ return /^[0-9a-f]{64}$/i.test(query.trim())
+}
+
+/** Prefer Archives resolution for ambiguous 64-char hex before defaulting to note/profile rows. */
+export function pickArchivesResolvedOverHexDefault(
+ resolved: TSearchParams,
+ userChoice: TSearchParams
+): TSearchParams {
+ if (!isAmbiguousHexSearchQuery(userChoice.search)) return userChoice
+ if (resolved.type === 'profile' || resolved.type === 'note') return resolved
+ return userChoice
+}
diff --git a/src/lib/nostr-archives-search.ts b/src/lib/nostr-archives-search.ts
new file mode 100644
index 00000000..14081e23
--- /dev/null
+++ b/src/lib/nostr-archives-search.ts
@@ -0,0 +1,37 @@
+import { mergedSearchNoteHasPreviewBody } from '@/lib/merged-search-note-preview'
+import nostrArchivesApi from '@/services/nostr-archives-api.service'
+import type { Event } from 'nostr-tools'
+
+export type TArchivesNotesSearchResult = {
+ ok: boolean
+ events: Event[]
+ total: number
+}
+
+/**
+ * Notes search via Nostr Archives REST (`GET /v1/notes/search`).
+ * Verified events are persisted by the API client; returns empty when API is unavailable.
+ */
+export async function searchArchivesNotesForGeneralSearch(params: {
+ query: string
+ kinds: readonly number[]
+ limit?: number
+}): Promise {
+ const q = params.query.trim()
+ if (!q || !nostrArchivesApi.isAvailable()) {
+ return { ok: false, events: [], total: 0 }
+ }
+
+ const kindSet = new Set(params.kinds)
+ if (kindSet.size === 0) return { ok: false, events: [], total: 0 }
+
+ const res = await nostrArchivesApi.searchNotes({
+ q,
+ limit: Math.min(100, params.limit ?? 100),
+ order: 'newest'
+ })
+ if (!res.ok) return { ok: false, events: [], total: 0 }
+
+ const events = res.data.notes.filter((ev) => kindSet.has(ev.kind) && mergedSearchNoteHasPreviewBody(ev))
+ return { ok: true, events, total: res.data.total }
+}
diff --git a/src/lib/note-page-load-pipeline.ts b/src/lib/note-page-load-pipeline.ts
new file mode 100644
index 00000000..3e6fcd9d
--- /dev/null
+++ b/src/lib/note-page-load-pipeline.ts
@@ -0,0 +1,69 @@
+import { archivesMetadataListToProfiles } from '@/lib/archives-profile-metadata'
+import client from '@/services/client.service'
+import { candidateKeysForNoteUrlId } from '@/services/navigation-event-store'
+import nostrArchivesApi from '@/services/nostr-archives-api.service'
+import noteStatsService from '@/services/note-stats.service'
+import type { TArchivesNotePageBundle } from '@/types/nostr-archives'
+import type { TProfile } from '@/types'
+import type { Event } from 'nostr-tools'
+
+function resolveEventPointerToHex(eventId: string): string | undefined {
+ const trimmed = eventId.trim()
+ if (/^[0-9a-f]{64}$/i.test(trimmed)) return trimmed.toLowerCase()
+ for (const key of candidateKeysForNoteUrlId(trimmed)) {
+ if (/^[0-9a-f]{64}$/i.test(key)) return key.toLowerCase()
+ }
+ return undefined
+}
+
+/** Single verified event from Archives `GET /v1/events/{id}` (persisted by API client). */
+export async function resolveNoteEventFromArchives(eventId: string): Promise {
+ if (!nostrArchivesApi.isAvailable()) return undefined
+ const hex = resolveEventPointerToHex(eventId)
+ if (!hex) return undefined
+
+ const res = await nostrArchivesApi.getEventById(hex)
+ if (!res.ok) return undefined
+
+ client.addEventToCache(res.data, { explicitNoteLookupHexId: hex })
+ return res.data
+}
+
+/** Full note page bundle: main event, replies, profile map, interaction counts. */
+export async function fetchArchivesNotePageBundle(
+ eventId: string,
+ limit = 50
+): Promise {
+ if (!nostrArchivesApi.isAvailable()) return undefined
+ const hex = resolveEventPointerToHex(eventId)
+ if (!hex) return undefined
+
+ const res = await nostrArchivesApi.getNotePage(hex, limit)
+ if (!res.ok) return undefined
+
+ noteStatsService.applyArchivesInteractionCounts(hex, res.data.interactions)
+ client.addEventToCache(res.data.event, { explicitNoteLookupHexId: hex })
+ for (const reply of res.data.replies) {
+ client.addEventToCache(reply)
+ }
+
+ return res.data
+}
+
+/** Profiles from a note page bundle (`GET /v1/pages/note/{id}` `profiles` map). */
+export function profilesFromArchivesNotePageBundle(bundle: TArchivesNotePageBundle): TProfile[] {
+ return archivesMetadataListToProfiles(Object.values(bundle.profiles))
+}
+
+/** Fire-and-forget: hydrate replies + interaction counts while the note panel opens. */
+export function prewarmArchivesNotePage(
+ eventId: string,
+ limit = 50,
+ onBundle?: (bundle: TArchivesNotePageBundle) => void
+): void {
+ void fetchArchivesNotePageBundle(eventId, limit)
+ .then((bundle) => {
+ if (bundle) onBundle?.(bundle)
+ })
+ .catch(() => {})
+}
diff --git a/src/lib/note-stats-archives-prefetch.ts b/src/lib/note-stats-archives-prefetch.ts
new file mode 100644
index 00000000..7a10d912
--- /dev/null
+++ b/src/lib/note-stats-archives-prefetch.ts
@@ -0,0 +1,94 @@
+import nostrArchivesApi from '@/services/nostr-archives-api.service'
+import noteStatsService from '@/services/note-stats.service'
+import type { TArchivesInteractionCounts } from '@/types/nostr-archives'
+
+const BATCH_DELAY_MS = 48
+const MAX_BATCH_SIZE = 20
+const RECENT_TTL_MS = 5 * 60_000
+
+const pending = new Set()
+const inFlight = new Set()
+const recentById = new Map()
+let batchTimer: ReturnType | null = null
+
+function normalizeHexNoteId(noteId: string): string | null {
+ const hex = noteId.trim().toLowerCase()
+ return /^[0-9a-f]{64}$/.test(hex) ? hex : null
+}
+
+function markRecent(id: string): void {
+ recentById.set(id, Date.now())
+ if (recentById.size > 500) {
+ const cutoff = Date.now() - RECENT_TTL_MS
+ for (const [k, t] of recentById) {
+ if (t < cutoff) recentById.delete(k)
+ }
+ }
+}
+
+function scheduleBatch(): void {
+ if (batchTimer != null) return
+ batchTimer = setTimeout(() => {
+ batchTimer = null
+ void flushBatch()
+ }, BATCH_DELAY_MS)
+}
+
+async function flushBatch(): Promise {
+ if (!nostrArchivesApi.isAvailable()) {
+ pending.clear()
+ return
+ }
+
+ const batch: string[] = []
+ for (const id of pending) {
+ if (batch.length >= MAX_BATCH_SIZE) break
+ if (inFlight.has(id)) continue
+ const recentAt = recentById.get(id)
+ if (recentAt != null && Date.now() - recentAt < RECENT_TTL_MS) {
+ pending.delete(id)
+ continue
+ }
+ batch.push(id)
+ pending.delete(id)
+ }
+
+ for (const id of batch) {
+ if (!nostrArchivesApi.isAvailable()) break
+ inFlight.add(id)
+ try {
+ const res = await nostrArchivesApi.getEventInteractions(id)
+ if (res.ok) {
+ markRecent(id)
+ noteStatsService.applyArchivesInteractionCounts(id, res.data)
+ }
+ } finally {
+ inFlight.delete(id)
+ }
+ }
+
+ if (pending.size > 0) scheduleBatch()
+}
+
+/** Queue Archives interaction counts for a note (batched; no-op when API unavailable). */
+export function queueArchivesInteractionPrefetch(noteId: string): void {
+ const hex = normalizeHexNoteId(noteId)
+ if (!hex || !nostrArchivesApi.isAvailable()) return
+ if (inFlight.has(hex)) return
+ const recentAt = recentById.get(hex)
+ if (recentAt != null && Date.now() - recentAt < RECENT_TTL_MS) return
+ pending.add(hex)
+ scheduleBatch()
+}
+
+export function resetArchivesInteractionPrefetchForTests(): void {
+ pending.clear()
+ inFlight.clear()
+ recentById.clear()
+ if (batchTimer != null) {
+ clearTimeout(batchTimer)
+ batchTimer = null
+ }
+}
+
+export type { TArchivesInteractionCounts }
diff --git a/src/lib/profile-metadata-batch.ts b/src/lib/profile-metadata-batch.ts
new file mode 100644
index 00000000..6c0acae0
--- /dev/null
+++ b/src/lib/profile-metadata-batch.ts
@@ -0,0 +1,67 @@
+import { archivesMetadataToProfile } from '@/lib/archives-profile-metadata'
+import { formatPubkey, pubkeyToNpub } from '@/lib/pubkey'
+import {
+ registerProfileBatchPubkeys,
+ unregisterProfileBatchPubkeys
+} from '@/lib/profile-batch-coordinator'
+import client from '@/services/client.service'
+import nostrArchivesApi from '@/services/nostr-archives-api.service'
+import type { TProfile } from '@/types'
+
+function normalizeHexPubkeys(pubkeys: readonly string[]): string[] {
+ const seen = new Set()
+ const out: string[] = []
+ for (const raw of pubkeys) {
+ const pk = raw.trim().toLowerCase()
+ if (!/^[0-9a-f]{64}$/.test(pk) || seen.has(pk)) continue
+ seen.add(pk)
+ out.push(pk)
+ }
+ return out
+}
+
+function placeholderProfile(pubkey: string): TProfile {
+ return {
+ pubkey,
+ npub: pubkeyToNpub(pubkey) ?? '',
+ username: formatPubkey(pubkey),
+ batchPlaceholder: true
+ }
+}
+
+/**
+ * Batch profile hydration: Nostr Archives `POST /v1/profiles/metadata` first, then
+ * {@link client.fetchProfilesForPubkeys} for pubkeys Archives did not return.
+ */
+export async function fetchProfilesMetadataBatch(pubkeys: readonly string[]): Promise {
+ const deduped = normalizeHexPubkeys(pubkeys)
+ if (deduped.length === 0) return []
+
+ registerProfileBatchPubkeys(deduped)
+ try {
+ const byPk = new Map()
+
+ if (nostrArchivesApi.isAvailable()) {
+ const res = await nostrArchivesApi.fetchProfilesMetadata(deduped)
+ if (res.ok) {
+ for (const meta of res.data.profiles) {
+ const profile = archivesMetadataToProfile(meta)
+ if (profile) byPk.set(profile.pubkey, profile)
+ }
+ }
+ }
+
+ const missing = deduped.filter((pk) => !byPk.has(pk))
+ if (missing.length > 0) {
+ const relayProfiles = await client.fetchProfilesForPubkeys(missing)
+ for (const p of relayProfiles) {
+ const pkNorm = p.pubkey.toLowerCase()
+ byPk.set(pkNorm, { ...p, pubkey: pkNorm })
+ }
+ }
+
+ return deduped.map((pk) => byPk.get(pk) ?? placeholderProfile(pk))
+ } finally {
+ unregisterProfileBatchPubkeys(deduped)
+ }
+}
diff --git a/src/lib/thread-context-local.ts b/src/lib/thread-context-local.ts
index a170fb9f..3a64174d 100644
--- a/src/lib/thread-context-local.ts
+++ b/src/lib/thread-context-local.ts
@@ -7,6 +7,7 @@ import {
resolveDeclaredThreadRootEventHex
} from '@/lib/event'
import { shouldDropEventOnIngest } from '@/lib/event-ingest-filter'
+import { resolveNoteEventFromArchives } from '@/lib/note-page-load-pipeline'
import client, { eventService } from '@/services/client.service'
import { loadArchivedEventForFetch } from '@/services/event-archive.service'
import { candidateKeysForNoteUrlId } from '@/services/navigation-event-store'
@@ -55,6 +56,11 @@ export async function resolveThreadContextEventFromLocalStores(
return fromArchive
}
+ const fromArchivesApi = await resolveNoteEventFromArchives(hex)
+ if (fromArchivesApi && !shouldDropEventOnIngest(fromArchivesApi, { explicitNoteLookupHexId: hex })) {
+ return fromArchivesApi
+ }
+
const fromPublication = await eventService.peekPublicationStoreEvent(hex)
if (fromPublication) return fromPublication
diff --git a/src/pages/secondary/FollowersListPage/index.tsx b/src/pages/secondary/FollowersListPage/index.tsx
new file mode 100644
index 00000000..b0c69c95
--- /dev/null
+++ b/src/pages/secondary/FollowersListPage/index.tsx
@@ -0,0 +1,215 @@
+import JsonViewDialog from '@/components/JsonViewDialog'
+import ProfileList from '@/components/ProfileList'
+import { RefreshButton } from '@/components/RefreshButton'
+import { Button } from '@/components/ui/button'
+import {
+ DropdownMenu,
+ DropdownMenuContent,
+ DropdownMenuItem,
+ DropdownMenuTrigger
+} from '@/components/ui/dropdown-menu'
+import { useFetchProfile } from '@/hooks'
+import { useNostrArchivesAvailable } from '@/hooks/useNostrArchivesAvailable'
+import SecondaryPageLayout from '@/layouts/SecondaryPageLayout'
+import { usePrimaryNoteView } from '@/contexts/primary-note-view-context'
+import nostrArchivesApi from '@/services/nostr-archives-api.service'
+import { Code, MoreVertical } from 'lucide-react'
+import { forwardRef, useCallback, useEffect, useRef, useState } from 'react'
+import { useTranslation } from 'react-i18next'
+
+const FOLLOWERS_PAGE_SIZE = 100
+
+function normalizeFollowerPubkey(pk: string): string | null {
+ const trimmed = pk.trim().toLowerCase()
+ return /^[0-9a-f]{64}$/.test(trimmed) ? trimmed : null
+}
+
+const FollowersListPage = forwardRef(
+ ({ id, index, hideTitlebar = false }: { id?: string; index?: number; hideTitlebar?: boolean }, ref) => {
+ const { t } = useTranslation()
+ const { registerPrimaryPanelRefresh } = usePrimaryNoteView()
+ const archivesAvailable = useNostrArchivesAvailable()
+ const [listRefreshNonce, setListRefreshNonce] = useState(0)
+ const { profile } = useFetchProfile(id)
+ const [followers, setFollowers] = useState([])
+ const [totalCount, setTotalCount] = useState(null)
+ const [hasMore, setHasMore] = useState(false)
+ const [phase, setPhase] = useState<'idle' | 'loading' | 'ready' | 'unavailable'>('idle')
+ const [jsonOpen, setJsonOpen] = useState(false)
+ const [followersJsonPayload, setFollowersJsonPayload] = useState(null)
+ const bottomRef = useRef(null)
+ const loadMoreInFlight = useRef(false)
+ const offsetRef = useRef(0)
+
+ const bumpList = useCallback(() => {
+ offsetRef.current = 0
+ setListRefreshNonce((n) => n + 1)
+ }, [])
+
+ const openFollowersJson = useCallback(() => {
+ setFollowersJsonPayload({
+ pubkey: profile?.pubkey ?? null,
+ source: 'nostr-archives',
+ endpoint: '/v1/social/{pubkey}',
+ followersOffset: offsetRef.current,
+ followersLimit: FOLLOWERS_PAGE_SIZE,
+ derivedFollowerPubkeys: followers,
+ totalCount
+ })
+ setJsonOpen(true)
+ }, [profile?.pubkey, followers, totalCount])
+
+ useEffect(() => {
+ if (!hideTitlebar) {
+ registerPrimaryPanelRefresh(null)
+ return
+ }
+ registerPrimaryPanelRefresh(bumpList)
+ return () => registerPrimaryPanelRefresh(null)
+ }, [hideTitlebar, registerPrimaryPanelRefresh, bumpList])
+
+ const fetchPage = useCallback(
+ async (offset: number, append: boolean) => {
+ const pk = profile?.pubkey
+ if (!pk || !archivesAvailable) return false
+
+ const res = await nostrArchivesApi.getSocialGraph(pk, {
+ followsLimit: 0,
+ followersLimit: FOLLOWERS_PAGE_SIZE,
+ followersOffset: offset
+ })
+ if (!res.ok) return false
+
+ const batch = res.data.followers.pubkeys
+ .map(normalizeFollowerPubkey)
+ .filter((x): x is string => x != null)
+
+ setTotalCount(res.data.followers.count)
+ setFollowers((prev) => {
+ if (!append) return batch
+ const seen = new Set(prev)
+ const out = [...prev]
+ for (const p of batch) {
+ if (!seen.has(p)) {
+ seen.add(p)
+ out.push(p)
+ }
+ }
+ return out
+ })
+ offsetRef.current = offset + batch.length
+ setHasMore(offsetRef.current < res.data.followers.count && batch.length > 0)
+ return true
+ },
+ [profile?.pubkey, archivesAvailable]
+ )
+
+ useEffect(() => {
+ let cancelled = false
+ const pk = profile?.pubkey
+
+ if (!pk) {
+ setFollowers([])
+ setTotalCount(null)
+ setHasMore(false)
+ setPhase('idle')
+ return
+ }
+
+ if (!archivesAvailable) {
+ setFollowers([])
+ setTotalCount(null)
+ setHasMore(false)
+ setPhase('unavailable')
+ return
+ }
+
+ setPhase('loading')
+ setFollowers([])
+ offsetRef.current = 0
+
+ void fetchPage(0, false).then((ok) => {
+ if (cancelled) return
+ setPhase(ok ? 'ready' : 'unavailable')
+ })
+
+ return () => {
+ cancelled = true
+ }
+ }, [profile?.pubkey, listRefreshNonce, archivesAvailable, fetchPage])
+
+ useEffect(() => {
+ const el = bottomRef.current
+ if (!el || !hasMore || phase !== 'ready') return
+
+ const observer = new IntersectionObserver(
+ (entries) => {
+ if (!entries[0]?.isIntersecting || loadMoreInFlight.current) return
+ loadMoreInFlight.current = true
+ void fetchPage(offsetRef.current, true).finally(() => {
+ loadMoreInFlight.current = false
+ })
+ },
+ { root: null, rootMargin: '120px', threshold: 0 }
+ )
+ observer.observe(el)
+ return () => observer.disconnect()
+ }, [hasMore, phase, fetchPage, followers.length])
+
+ const title =
+ hideTitlebar
+ ? undefined
+ : profile?.username
+ ? t("username's followers", { username: profile.username })
+ : t('Followers')
+
+ return (
+
+
+
+
+
+
+
+ openFollowersJson()}>
+