Class EventMemory

An in-memory database of events

Implements

IEventMemory

Constructors

constructor

new EventMemory(): EventMemory
Returns EventMemory

Properties

`Protected`authors

authors: Map<string, Set<NostrEvent>> = ...

`Protected`claims

claims: WeakMap<NostrEvent, number> = ...

A weak map of events to claim reference counts

`Protected`created_at

created_at: NostrEvent[] = []

events

events: LRU<NostrEvent> = ...

LRU cache of last events touched

`Protected`kindAuthor

kindAuthor: Map<string, Set<NostrEvent>> = ...

Composite index for kind+author queries (common pattern)

`Protected`kinds

kinds: Map<number, Set<NostrEvent>> = ...

Indexes

`Protected`log

log: Debugger = ...

`Protected`replaceable

replaceable: Map<string, NostrEvent[]> = ...

A sorted array of replaceable events by address

`Protected`tags

tags: LRU<Set<NostrEvent>> = ...

Accessors

size

get size(): number
The number of events in the database

Returns number
- Defined in packages/core/src/event-store/event-memory.ts:33

Methods

add

add(event: NostrEvent): NostrEvent
Inserts an event into the database and notifies all subscriptions
Parameters
- event: NostrEvent
Returns NostrEvent
Implementation of IEventMemory.add
- Defined in packages/core/src/event-store/event-memory.ts:76

claim

claim(event: NostrEvent): void
Increments the claim count on the event and touches it
Parameters
- event: NostrEvent
Returns void
Implementation of IEventMemory.claim
- Defined in packages/core/src/event-store/event-memory.ts:188

clearClaim

clearClaim(event: NostrEvent): void
Removes all claims on an event
Parameters
- event: NostrEvent
Returns void
Implementation of IEventMemory.clearClaim
- Defined in packages/core/src/event-store/event-memory.ts:213

`Protected`getAuthorsIndex

getAuthorsIndex(author: string): Set<NostrEvent>
Parameters
- author: string
Returns Set<NostrEvent>
- Defined in packages/core/src/event-store/event-memory.ts:249

getByFilters

getByFilters(filters: Filter | Filter[]): NostrEvent[]
Gets all events that match the filters
Parameters
- filters: Filter | Filter[]
Returns NostrEvent[]
Implementation of IEventMemory.getByFilters
- Defined in packages/core/src/event-store/event-memory.ts:64

getEvent

getEvent(id: string): NostrEvent | undefined
Gets a single event based on id
Parameters
- id: string
Returns NostrEvent | undefined
Implementation of IEventMemory.getEvent
- Defined in packages/core/src/event-store/event-memory.ts:42

`Protected`getEventsForFilter

getEventsForFilter(filter: Filter): Set<NostrEvent>
Returns all events that match the filter
Parameters
- filter: Filter
Returns Set<NostrEvent>
- Defined in packages/core/src/event-store/event-memory.ts:408

`Protected`getEventsForFilters

getEventsForFilters(filters: Filter[]): Set<NostrEvent>
Returns all events that match the filters
Parameters
- filters: Filter[]
Returns Set<NostrEvent>
- Defined in packages/core/src/event-store/event-memory.ts:513

`Protected`getKindAuthorIndex

getKindAuthorIndex(kind: number, pubkey: string): Set<NostrEvent>
Parameters
- kind: number
- pubkey: string
Returns Set<NostrEvent>
- Defined in packages/core/src/event-store/event-memory.ts:253

`Protected`getKindIndex

getKindIndex(kind: number): Set<NostrEvent>
Index helper methods
Parameters
- kind: number
Returns Set<NostrEvent>
- Defined in packages/core/src/event-store/event-memory.ts:245

getReplaceable

getReplaceable(
    kind: number,
    pubkey: string,
    identifier?: string,
): NostrEvent | undefined
Gets the latest replaceable event
Parameters
- kind: number
- pubkey: string
- Optionalidentifier: string
Returns NostrEvent | undefined
Implementation of IEventMemory.getReplaceable
- Defined in packages/core/src/event-store/event-memory.ts:52

getReplaceableHistory

getReplaceableHistory(
    kind: number,
    pubkey: string,
    identifier?: string,
): NostrEvent[] | undefined
Gets the history of a replaceable event
Parameters
- kind: number
- pubkey: string
- Optionalidentifier: string
Returns NostrEvent[] | undefined
Implementation of IEventMemory.getReplaceableHistory
- Defined in packages/core/src/event-store/event-memory.ts:58

`Protected`getTagIndex

getTagIndex(tagAndValue: string): Set<NostrEvent>
Parameters
- tagAndValue: string
Returns Set<NostrEvent>
- Defined in packages/core/src/event-store/event-memory.ts:258

getTimeline

getTimeline(filters: Filter | Filter[]): NostrEvent[]
Gets a timeline of events that match the filters
Parameters
- filters: Filter | Filter[]
Returns NostrEvent[]
Implementation of IEventMemory.getTimeline
- Defined in packages/core/src/event-store/event-memory.ts:68

hasEvent

hasEvent(id: string): boolean
Checks if the database contains an event without touching it
Parameters
- id: string
Returns boolean
Implementation of IEventMemory.hasEvent
- Defined in packages/core/src/event-store/event-memory.ts:38

hasReplaceable

hasReplaceable(kind: number, pubkey: string, identifier?: string): boolean
Checks if the event set has a replaceable event
Parameters
- kind: number
- pubkey: string
- Optionalidentifier: string
Returns boolean
Implementation of IEventMemory.hasReplaceable
- Defined in packages/core/src/event-store/event-memory.ts:47

isClaimed

isClaimed(event: NostrEvent): boolean
Checks if an event is claimed by anything
Parameters
- event: NostrEvent
Returns boolean
Implementation of IEventMemory.isClaimed
- Defined in packages/core/src/event-store/event-memory.ts:196

iterateAuthors

iterateAuthors(authors: Iterable<string>): Generator<NostrEvent>
Iterates over all events by author
Parameters
- authors: Iterable<string>
Returns Generator<NostrEvent>
- Defined in packages/core/src/event-store/event-memory.ts:328

iterateIds

iterateIds(ids: Iterable<string>): Generator<NostrEvent>
Iterates over all events by id
Parameters
- ids: Iterable<string>
Returns Generator<NostrEvent>
- Defined in packages/core/src/event-store/event-memory.ts:401

iterateKinds

iterateKinds(kinds: Iterable<number>): Generator<NostrEvent>
Iterates over all events by kind
Parameters
- kinds: Iterable<number>
Returns Generator<NostrEvent>
- Defined in packages/core/src/event-store/event-memory.ts:350

iterateTag

iterateTag(tag: string, values: Iterable<string>): Generator<NostrEvent>
Iterates over all events by indexable tag and value
Parameters
- tag: string
- values: Iterable<string>
Returns Generator<NostrEvent>
- Defined in packages/core/src/event-store/event-memory.ts:339

iterateTime

iterateTime(
since: number | undefined,
until: number | undefined,
): Generator<NostrEvent>
Iterates over all events by time
Parameters
- since: number | undefined
- until: number | undefined
Returns Generator<NostrEvent>
- Defined in packages/core/src/event-store/event-memory.ts:361

prune

prune(limit?: number): number
Removes events that are not claimed (free up memory)
Parameters
- Optionallimit: number
Returns number
- Defined in packages/core/src/event-store/event-memory.ts:230

remove

remove(eventOrId: string | NostrEvent): boolean
Removes an event from the database and notifies all subscriptions
Parameters
- eventOrId: string | NostrEvent
Returns boolean
Implementation of IEventMemory.remove
- Defined in packages/core/src/event-store/event-memory.ts:114

removeByFilters

removeByFilters(filters: Filter | Filter[]): number
Remove multiple events that match the given filters
Parameters
- filters: Filter | Filter[]
Returns number
- Defined in packages/core/src/event-store/event-memory.ts:158

removeClaim

removeClaim(event: NostrEvent): void
Decrements the claim count on an event
Parameters
- event: NostrEvent
Returns void
Implementation of IEventMemory.removeClaim
- Defined in packages/core/src/event-store/event-memory.ts:201

`Protected`removeFromSortedArray

removeFromSortedArray(array: NostrEvent[], event: NostrEvent): void
Helper method to remove an event from a sorted array using binary search. Falls back to indexOf if binary search doesn't find exact match.
Parameters
- array: NostrEvent[]
- event: NostrEvent
Returns void
- Defined in packages/core/src/event-store/event-memory.ts:281

reset

reset(): void
Resets the event set

Returns void
- Defined in packages/core/src/event-store/event-memory.ts:527

touch

touch(event: NostrEvent): void
Moves an event to the top of the LRU cache
Parameters
- event: NostrEvent
Returns void
Implementation of IEventMemory.touch
- Defined in packages/core/src/event-store/event-memory.ts:179

unclaimed

unclaimed(): Generator<NostrEvent>
Returns a generator of unclaimed events in order of least used

Returns Generator<NostrEvent>
Implementation of IEventMemory.unclaimed
- Defined in packages/core/src/event-store/event-memory.ts:217

update

update(_event: NostrEvent): void
Notify the database that an event has updated
Parameters
- _event: NostrEvent
Returns void
- Defined in packages/core/src/event-store/event-memory.ts:171

Class EventMemory

Implements

Index

Constructors

Properties

Accessors

Methods

Constructors

constructor

Returns EventMemory

Properties

Protectedauthors

Protectedclaims

Protectedcreated_at

events

ProtectedkindAuthor

Protectedkinds

Protectedlog

Protectedreplaceable

Protectedtags

Accessors

size

Returns number

Methods

add

Parameters

Returns NostrEvent

claim

Parameters

Returns void

clearClaim

Parameters

Returns void

ProtectedgetAuthorsIndex

Parameters

Returns Set<NostrEvent>

getByFilters

Parameters

Returns NostrEvent[]

getEvent

Parameters

Returns NostrEvent | undefined

ProtectedgetEventsForFilter

Parameters

Returns Set<NostrEvent>

ProtectedgetEventsForFilters

Parameters

Returns Set<NostrEvent>

ProtectedgetKindAuthorIndex

Parameters

Returns Set<NostrEvent>

ProtectedgetKindIndex

Parameters

Returns Set<NostrEvent>

getReplaceable

Parameters

Returns NostrEvent | undefined

getReplaceableHistory

Parameters

Returns NostrEvent[] | undefined

ProtectedgetTagIndex

Parameters

Returns Set<NostrEvent>

getTimeline

Parameters

Returns NostrEvent[]

hasEvent

Parameters

Returns boolean

hasReplaceable

Parameters

Returns boolean

isClaimed

Parameters

Returns boolean

iterateAuthors

Parameters

Returns Generator<NostrEvent>

iterateIds

Parameters

`Protected`authors

`Protected`claims

`Protected`created_at

`Protected`kindAuthor

`Protected`kinds

`Protected`log

`Protected`replaceable

`Protected`tags

`Protected`getAuthorsIndex

`Protected`getEventsForFilter

`Protected`getEventsForFilters

`Protected`getKindAuthorIndex

`Protected`getKindIndex

`Protected`getTagIndex

`Protected`removeFromSortedArray