Class NetworkAdapter`Abstract`

An interface representing some way to connect to other peers

Remarks

The Repo uses one or more NetworkAdapters to connect to other peers. Because the network may take some time to be ready the Repo will wait until the adapter emits a ready event before it starts trying to use it

This utility class can be used as a base to build a custom network adapter. It is most useful as a simple way to add the necessary event emitter functionality

Hierarchy

EventEmitter<NetworkAdapterEvents>
- NetworkAdapter

Implements

NetworkAdapterInterface

Index

Constructors

constructor

new NetworkAdapter(): NetworkAdapter
Returns NetworkAdapter
Inherited from EventEmitter<NetworkAdapterEvents>.constructor

Properties

`Optional`peerId

peerId?: PeerId

`Optional`peerMetadata

peerMetadata?: PeerMetadata

`Static`prefixed

prefixed: string | boolean

Methods

addListener

addListener<T extends keyof NetworkAdapterEvents>(
    event: T,
    fn: (
        ...args: ArgumentMap<NetworkAdapterEvents>[Extract<
            T,
            keyof NetworkAdapterEvents,
        >],
    ) => void,
    context?: any,
): this
Type Parameters
- T extends keyof NetworkAdapterEvents
Parameters
- event: T
- fn: (
      ...args: ArgumentMap<NetworkAdapterEvents>[Extract<
          T,
          keyof NetworkAdapterEvents,
      >],
  ) => void
- Optionalcontext: any
Returns this
Implementation of NetworkAdapterInterface.addListener
Inherited from EventEmitter.addListener
- Defined in node_modules/.pnpm/[email protected]/node_modules/eventemitter3/index.d.ts:45

`Abstract`connect

connect(peerId: PeerId, peerMetadata?: PeerMetadata): void
Called by the Repo to start the connection process
Parameters
- peerId: PeerId
- OptionalpeerMetadata: PeerMetadata
Returns void
Argument
peerId - the peerId of this repo

Argument
peerMetadata - how this adapter should present itself to other peers
Implementation of NetworkAdapterInterface.connect
- Defined in packages/automerge-repo/src/network/NetworkAdapter.ts:34

`Abstract`disconnect

disconnect(): void
Called by the Repo to disconnect from the network

Returns void
Implementation of NetworkAdapterInterface.disconnect
- Defined in packages/automerge-repo/src/network/NetworkAdapter.ts:43

emit

emit<T extends keyof NetworkAdapterEvents>(
    event: T,
    ...args: ArgumentMap<NetworkAdapterEvents>[Extract<
        T,
        keyof NetworkAdapterEvents,
    >],
): boolean
Calls each of the listeners registered for a given event.
Type Parameters
- T extends keyof NetworkAdapterEvents
Parameters
- event: T
- ...args: ArgumentMap<NetworkAdapterEvents>[Extract<T, keyof NetworkAdapterEvents>]
Returns boolean
Implementation of NetworkAdapterInterface.emit
Inherited from EventEmitter.emit
- Defined in node_modules/.pnpm/[email protected]/node_modules/eventemitter3/index.d.ts:32

eventNames

eventNames(): (keyof NetworkAdapterEvents)[]
Return an array listing the events for which the emitter has registered listeners.

Returns (keyof NetworkAdapterEvents)[]
Implementation of NetworkAdapterInterface.eventNames
Inherited from EventEmitter.eventNames
- Defined in node_modules/.pnpm/[email protected]/node_modules/eventemitter3/index.d.ts:15

`Abstract`isReady

isReady(): boolean
Returns boolean
Implementation of NetworkAdapterInterface.isReady
- Defined in packages/automerge-repo/src/network/NetworkAdapter.ts:26

listenerCount

listenerCount(event: keyof NetworkAdapterEvents): number
Return the number of listeners listening to a given event.
Parameters
- event: keyof NetworkAdapterEvents
Returns number
Implementation of NetworkAdapterInterface.listenerCount
Inherited from EventEmitter.listenerCount
- Defined in node_modules/.pnpm/[email protected]/node_modules/eventemitter3/index.d.ts:27

listeners

listeners<T extends keyof NetworkAdapterEvents>(
    event: T,
): (
    (
        ...args: ArgumentMap<NetworkAdapterEvents>[Extract<
            T,
            keyof NetworkAdapterEvents,
        >],
    ) => void
)[]
Return the listeners registered for a given event.
Type Parameters
- T extends keyof NetworkAdapterEvents
Parameters
- event: T
Returns (
    (
        ...args: ArgumentMap<NetworkAdapterEvents>[Extract<
            T,
            keyof NetworkAdapterEvents,
        >],
    ) => void
)[]
Implementation of NetworkAdapterInterface.listeners
Inherited from EventEmitter.listeners
- Defined in node_modules/.pnpm/[email protected]/node_modules/eventemitter3/index.d.ts:20

off

off<T extends keyof NetworkAdapterEvents>(
    event: T,
    fn?: (
        ...args: ArgumentMap<NetworkAdapterEvents>[Extract<
            T,
            keyof NetworkAdapterEvents,
        >],
    ) => void,
    context?: any,
    once?: boolean,
): this
Type Parameters
- T extends keyof NetworkAdapterEvents
Parameters
- event: T
- Optionalfn: (
      ...args: ArgumentMap<NetworkAdapterEvents>[Extract<
          T,
          keyof NetworkAdapterEvents,
      >],
  ) => void
- Optionalcontext: any
- Optionalonce: boolean
Returns this
Implementation of NetworkAdapterInterface.off
Inherited from EventEmitter.off
- Defined in node_modules/.pnpm/[email protected]/node_modules/eventemitter3/index.d.ts:69

on

on<T extends keyof NetworkAdapterEvents>(
    event: T,
    fn: (
        ...args: ArgumentMap<NetworkAdapterEvents>[Extract<
            T,
            keyof NetworkAdapterEvents,
        >],
    ) => void,
    context?: any,
): this
Add a listener for a given event.
Type Parameters
- T extends keyof NetworkAdapterEvents
Parameters
- event: T
- fn: (
      ...args: ArgumentMap<NetworkAdapterEvents>[Extract<
          T,
          keyof NetworkAdapterEvents,
      >],
  ) => void
- Optionalcontext: any
Returns this
Implementation of NetworkAdapterInterface.on
Inherited from EventEmitter.on
- Defined in node_modules/.pnpm/[email protected]/node_modules/eventemitter3/index.d.ts:40

once

once<T extends keyof NetworkAdapterEvents>(
    event: T,
    fn: (
        ...args: ArgumentMap<NetworkAdapterEvents>[Extract<
            T,
            keyof NetworkAdapterEvents,
        >],
    ) => void,
    context?: any,
): this
Add a one-time listener for a given event.
Type Parameters
- T extends keyof NetworkAdapterEvents
Parameters
- event: T
- fn: (
      ...args: ArgumentMap<NetworkAdapterEvents>[Extract<
          T,
          keyof NetworkAdapterEvents,
      >],
  ) => void
- Optionalcontext: any
Returns this
Implementation of NetworkAdapterInterface.once
Inherited from EventEmitter.once
- Defined in node_modules/.pnpm/[email protected]/node_modules/eventemitter3/index.d.ts:54

removeAllListeners

removeAllListeners(event?: keyof NetworkAdapterEvents): this
Remove all listeners, or those of the specified event.
Parameters
- Optionalevent: keyof NetworkAdapterEvents
Returns this
Implementation of NetworkAdapterInterface.removeAllListeners
Inherited from EventEmitter.removeAllListeners
- Defined in node_modules/.pnpm/[email protected]/node_modules/eventemitter3/index.d.ts:79

removeListener

removeListener<T extends keyof NetworkAdapterEvents>(
    event: T,
    fn?: (
        ...args: ArgumentMap<NetworkAdapterEvents>[Extract<
            T,
            keyof NetworkAdapterEvents,
        >],
    ) => void,
    context?: any,
    once?: boolean,
): this
Remove the listeners of a given event.
Type Parameters
- T extends keyof NetworkAdapterEvents
Parameters
- event: T
- Optionalfn: (
      ...args: ArgumentMap<NetworkAdapterEvents>[Extract<
          T,
          keyof NetworkAdapterEvents,
      >],
  ) => void
- Optionalcontext: any
- Optionalonce: boolean
Returns this
Implementation of NetworkAdapterInterface.removeListener
Inherited from EventEmitter.removeListener
- Defined in node_modules/.pnpm/[email protected]/node_modules/eventemitter3/index.d.ts:63

`Abstract`send

send(message: Message): void
Called by the Repo to send a message to a peer
Parameters
- message: Message
Returns void
Argument
message - the message to send
Implementation of NetworkAdapterInterface.send
- Defined in packages/automerge-repo/src/network/NetworkAdapter.ts:40

`Abstract`whenReady

whenReady(): Promise<void>
Returns Promise<void>
Implementation of NetworkAdapterInterface.whenReady
- Defined in packages/automerge-repo/src/network/NetworkAdapter.ts:27

Class NetworkAdapterAbstract

Remarks

Hierarchy

Implements

Index

Constructors

Properties

Methods

Constructors

constructor

Returns NetworkAdapter

Properties

OptionalpeerId

OptionalpeerMetadata

Staticprefixed

Methods

addListener

Type Parameters

Parameters

Returns this

Abstractconnect

Parameters

Returns void

Argument

Argument

Abstractdisconnect

Returns void

emit

Type Parameters

Parameters

Returns boolean

eventNames

Returns (keyof NetworkAdapterEvents)[]

AbstractisReady

Returns boolean

listenerCount

Parameters

Returns number

listeners

Type Parameters

Parameters

Returns ( ( ...args: ArgumentMap<NetworkAdapterEvents>[Extract< T, keyof NetworkAdapterEvents, >], ) => void)[]

off

Type Parameters

Parameters

Returns this

on

Type Parameters

Parameters

Returns this

once

Type Parameters

Parameters

Returns this

removeAllListeners

Parameters

Returns this

removeListener

Type Parameters

Parameters

Returns this

Abstractsend

Parameters

Returns void

Argument

AbstractwhenReady

Returns Promise<void>

Settings

On This Page

Class NetworkAdapter`Abstract`

`Optional`peerId

`Optional`peerMetadata

`Static`prefixed

`Abstract`connect

`Abstract`disconnect

`Abstract`isReady

Returns (
(
...args: ArgumentMap<NetworkAdapterEvents>[Extract<
T,
keyof NetworkAdapterEvents,
>],
) => void
)[]

`Abstract`send

`Abstract`whenReady