JSPM

  • Created
  • Published
  • Downloads 74
  • Score
    100M100P100Q79225F
  • License MIT

A network swarm that uses discovery-channel to find peers

Package Exports

  • discovery-swarm

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (discovery-swarm) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

discovery-swarm

A network swarm that uses discovery-channel to find and connect to peers.

This module implements peer connection state and builds on discovery-channel which implements peer discovery. This uses TCP sockets by default and has experimental support for UTP.

npm install discovery-swarm

build status

Usage

var swarm = require('discovery-swarm')

var sw = swarm()

sw.listen(1000)
sw.add('ubuntu-14.04') // can be any id/name/hash

sw.on('connection', function (connection) {
  console.log('found + connected to peer')
})

API

var sw = swarm()

Create a new swarm

sw.add(key)

Add key (usually a name, hash or id, must be a Buffer) to the list of keys to use to discover and connect to peers. After adding will immediately search for peers advertising this key, and re-announce on a timer.

sw.remove(key)

Remove key from the list of keys

sw.peersQueued

Number of peers discovered but not connected to yet

sw.peersConnecting

Number of peers we are trying to connect to

sw.peersConnected

Number of peers we are actively connected to. Same as sw.connections.length.

sw.connections

List of active connections to other peers

sw.on('connection', connection)

Emitted when you connect to another peer

sw.listen(port)

Listen on a specific port. Should be called before add

License

MIT