Class PeerStore

fires

PeerStore#peer Emitted when a new peer is added.

fires

PeerStore#change:protocols Emitted when a known peer supports a different set of protocols.

fires

PeerStore#change:multiaddrs Emitted when a known peer has a different set of multiaddrs.

fires

PeerStore#change:pubkey Emitted emitted when a peer's public key is known.

fires

PeerStore#change:metadata Emitted when the known metadata of a peer change.

Hierarchy

  • EventEmitter
    • PeerStore

Index

References

Address

Re-exports Address

Constructors

constructor

Properties

_peerId

_peerId: PeerId

addressBook

addressBook: AddressBook

AddressBook containing a map of peerIdStr to Address.

keyBook

keyBook: KeyBook

KeyBook containing a map of peerIdStr to their PeerId with public keys.

metadataBook

metadataBook: MetadataBook

MetadataBook containing a map of peerIdStr to their metadata Map.

protoBook

protoBook: ProtoBook

ProtoBook containing a map of peerIdStr to supported protocols.

Static defaultMaxListeners

defaultMaxListeners: number

Static Readonly errorMonitor

errorMonitor: unique symbol

This symbol shall be used to install a listener for only monitoring 'error' events. Listeners installed using this symbol are called before the regular 'error' listeners are called.

Installing a listener using this symbol does not change the behavior once an 'error' event is emitted, therefore the process will still crash if no regular 'error' listener is installed.

Accessors

peers

  • get peers(): Map<string, { addresses: Address[]; id: PeerId; metadata: Map<string, Uint8Array> | undefined; protocols: string[] }>
  • Get all the stored information of every peer known.

    Returns Map<string, { addresses: Address[]; id: PeerId; metadata: Map<string, Uint8Array> | undefined; protocols: string[] }>

Methods

addListener

  • addListener(event: string | symbol, listener: (...args: any[]) => void): this
  • Parameters

    • event: string | symbol
    • listener: (...args: any[]) => void
        • (...args: any[]): void
        • Parameters

          • Rest ...args: any[]

          Returns void

    Returns this

delete

  • delete(peerId: PeerId): boolean
  • Delete the information of the given peer in every book.

    Parameters

    Returns boolean

    true if found and removed

emit

  • emit(event: string | symbol, ...args: any[]): boolean
  • Parameters

    • event: string | symbol
    • Rest ...args: any[]

    Returns boolean

eventNames

  • eventNames(): Array<string | symbol>

get

  • get(peerId: PeerId): { addresses: Address[]; id: PeerId; metadata: Map<string, Uint8Array> | undefined; protocols: string[] } | undefined
  • Get the stored information of a given peer.

    Parameters

    Returns { addresses: Address[]; id: PeerId; metadata: Map<string, Uint8Array> | undefined; protocols: string[] } | undefined

getMaxListeners

  • getMaxListeners(): number

listenerCount

  • listenerCount(event: string | symbol): number

listeners

  • listeners(event: string | symbol): Function[]

off

  • off(event: string | symbol, listener: (...args: any[]) => void): this
  • Parameters

    • event: string | symbol
    • listener: (...args: any[]) => void
        • (...args: any[]): void
        • Parameters

          • Rest ...args: any[]

          Returns void

    Returns this

on

  • on(event: string | symbol, listener: (...args: any[]) => void): this
  • Parameters

    • event: string | symbol
    • listener: (...args: any[]) => void
        • (...args: any[]): void
        • Parameters

          • Rest ...args: any[]

          Returns void

    Returns this

once

  • once(event: string | symbol, listener: (...args: any[]) => void): this
  • Parameters

    • event: string | symbol
    • listener: (...args: any[]) => void
        • (...args: any[]): void
        • Parameters

          • Rest ...args: any[]

          Returns void

    Returns this

prependListener

  • prependListener(event: string | symbol, listener: (...args: any[]) => void): this
  • Parameters

    • event: string | symbol
    • listener: (...args: any[]) => void
        • (...args: any[]): void
        • Parameters

          • Rest ...args: any[]

          Returns void

    Returns this

prependOnceListener

  • prependOnceListener(event: string | symbol, listener: (...args: any[]) => void): this
  • Parameters

    • event: string | symbol
    • listener: (...args: any[]) => void
        • (...args: any[]): void
        • Parameters

          • Rest ...args: any[]

          Returns void

    Returns this

rawListeners

  • rawListeners(event: string | symbol): Function[]

removeAllListeners

  • removeAllListeners(event?: string | symbol): this

removeListener

  • removeListener(event: string | symbol, listener: (...args: any[]) => void): this
  • Parameters

    • event: string | symbol
    • listener: (...args: any[]) => void
        • (...args: any[]): void
        • Parameters

          • Rest ...args: any[]

          Returns void

    Returns this

setMaxListeners

  • setMaxListeners(n: number): this

start

  • start(): void
  • Start the PeerStore.

    Returns void

stop

  • stop(): void
  • Stop the PeerStore.

    Returns void

Static listenerCount

  • listenerCount(emitter: EventEmitter, event: string | symbol): number
  • deprecated

    since v4.0.0

    Parameters

    • emitter: EventEmitter
    • event: string | symbol

    Returns number