ssb-gossip
ssb-server gossip plugin
Last updated a year ago by arj03 .
MIT · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install ssb-gossip 
SYNC missed versions from official npm registry.

ssb-gossip

ssb-server gossip plugin

to have a peer to peer network, a ssb instance needs to have some other peers to connect with. This module keeps track of those peers. There are a number of ways a you can know about a peer,

Notice these are mostly managed by other plugins.

The gossip plugin then decides when to connect to those peers, which it does mostly randomly. (connecting randomly means you will eventually connect to everyone, thus a useful database property: eventual consistency)

peers: sync

Get the current known peers.

peers
peers(cb)

add: sync

Add a peer.

#add a multiserver address.
add {addr}
#legacy format
add --host {string} --port {number} --key {feedid}
add(addr, cb)
add({ host:, port:, key: }, cb)
  • addr (address string): A multiserver address
  • host (host string): IP address or hostname.
  • port (port number)
  • key (feedid)

remove: sync

Remove an address from the peer table.

remove {addr}
remove --host {string} --port {number} --key {feedid}
remove(addr)
remove({ host:, port:, key: })

ping: duplex

used internally by the gossip plugin to measure latency and clock skew

connect: async

Add an address to the peer table, and connect immediately.

connect {addr}
connect --host {string} --port {number} --key {feedid}
connect(addr, cb)
connect({ host:, port:, key: }, cb)
  • addr (address string): An address string, of the following format: hostname:port:feedid.
  • host (host string): IP address or hostname.
  • port (port number)
  • key (feedid)

changes: source

Listen for gossip events.

changes
changes()

Events come in the following forms:

{ type: 'discover', peer:, source: }
{ type: 'connect', peer: }
{ type: 'connect-failure', peer: }
{ type: 'disconnect', peer: }

reconnect: sync

Tell ssb-server to reinitiate gossip connections now.

enable: sync

Update the config to enable a gossip type.

enable {type}
enable(type, cb)
  • type (string): The type of gossip to enable: local, global, or seed. Default global.

disable: sync

Update the config to disable a gossip type.

disable {type}
disable(type, cb)
  • type (string): The type of gossip to enable: local, global, or seed. Default global.

License

MIT

Current Tags

  • 1.1.1                                ...           latest (a year ago)

13 Versions

  • 1.1.1                                ...           a year ago
  • 1.1.0                                ...           a year ago
  • 1.0.10                                ...           2 years ago
  • 1.0.9                                ...           2 years ago
  • 1.0.8                                ...           2 years ago
  • 1.0.7                                ...           2 years ago
  • 1.0.6                                ...           2 years ago
  • 1.0.5                                ...           2 years ago
  • 1.0.4                                ...           2 years ago
  • 1.0.3                                ...           2 years ago
  • 1.0.2                                ...           2 years ago
  • 1.0.1                                ...           2 years ago
  • 1.0.0                                ...           2 years ago

Copyright 2014 - 2016 © taobao.org |