# sigver

> Signaling server for Netflux API based on WebSocket

Latest version **20.1.0** (published 2020-04-26) · MIT license · 0 weekly downloads

> **Deprecated.** This package is deprecated.

## Install

```sh
npm install sigver
pnpm add sigver
yarn add sigver
bun add sigver
```

Provides the command `sigver`.

## Health

**Score 10/100 (F)** — status: deprecated.

Negative: deprecated.

## Facts

| | |
|---|---|
| Version | 20.1.0 |
| Published | 2020-04-26 |
| First published | 2016-01-14 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Node | >=8.1.4 |
| Dependencies | 6 |
| Unpacked size | 16.8 KB |
| Known vulnerabilities | 0 (+10 in 1 direct dependencies) |
| Install scripts | no |
| GitHub stars | 35 |
| Author | Philippe Kalitine |
| Maintainers | kalitine |
| Keywords | WebRTC, WebSocket, Server-Sent-Event, signaling, server, netflux |

## Links

- npm: https://www.npmjs.com/package/sigver
- Repository: https://github.com/coast-team/sigver
- Homepage: https://github.com/coast-team/sigver#readme
- Issues: https://github.com/coast-team/sigver/issues
- npm.io page: https://npm.io/package/sigver

## Dependencies (6)

- [ws](https://npm.io/package/ws.md) ^7.2.3
- [pino](https://npm.io/package/pino.md) ^6.0.0
- [rxjs](https://npm.io/package/rxjs.md) ^6.5.4
- [commander](https://npm.io/package/commander.md) ^5.0.0
- [bufferutil](https://npm.io/package/bufferutil.md) ^4.0.1
- [protobufjs](https://npm.io/package/protobufjs.md) ^6.8.9

## Alternatives

- [@opentelemetry/exporter-zipkin](https://npm.io/package/@opentelemetry/exporter-zipkin.md) — 14.8M weekly downloads
- [pusher-js](https://npm.io/package/pusher-js.md) — 2.0M weekly downloads
- [browserify](https://npm.io/package/browserify.md) — 1.7M weekly downloads
- [sqs-consumer](https://npm.io/package/sqs-consumer.md) — 1.7M weekly downloads
- [@sanity/eventsource](https://npm.io/package/@sanity/eventsource.md) — 930.8K weekly downloads

## Recent versions

- 20.1.0 (latest) — 2020-04-26
- 20.0.4 — 2020-04-25
- 20.0.3 — 2020-03-25
- 20.0.2 — 2018-09-06
- 20.0.1 — 2018-07-30
- 20.0.0 — 2018-06-22
- 19.1.2 — 2018-06-01
- 19.1.1 — 2018-05-24
- 19.1.0 — 2018-05-24
- 19.0.0 — 2018-05-02
- 18.0.0 — 2018-02-22
- 17.0.1 — 2018-01-22
- 17.0.0 — 2018-01-04
- 16.0.0 — 2017-12-19
- 15.1.0 — 2017-12-19
- … 46 more at https://npm.io/package/sigver/versions

## README

# Sigver

[![travis](https://travis-ci.org/coast-team/sigver.svg?branch=master&style=flat-square)](https://travis-ci.org/coast-team/sigver)
[![version](https://img.shields.io/npm/v/sigver.svg?style=flat-square)](https://www.npmjs.com/package/sigver)

WebRTC Signaling server based on **WebSocket** for [**Netflux API**](https://coast-team.github.io/netflux), Javascript client and server side transport API for establishing peer to peer network.

## Install

```shell
npm install -g sigver
```

## Run

```shell
Usage: sigver [options]

Signaling server for WebRTC. Used by Netflux API (https://coast-team.github.io/netflux/)

Options:

  -V, --version           output the version number
  -h, --host <ip>         Select host address to bind to (default: 0.0.0.0)
  -p, --port <number>     Select port to use (default: 8000)
  -k, --key <file path>   Private key for the certificate.
  -c, --cert <file path>  The server certificate.
  -a, --ca <file path>    The additional intermediate certificate or certificates that web browsers will need in order to validate the server certificate.
  -h, --help              output usage information

Examples:

  $ sigver                       # Signaling server is listening on 0.0.0.0:8000
  $ sigver -h 192.168.0.1 -p 80  # Signaling server is listening on 192.168.0.1:80
  $ sigver --key ./private.key --cert ./primary.crt --ca ./intermediate.crt --port 443  # Signaling server is listening on 0.0.0.0:443
```

## Server protocol

Server uses [Protocol Buffers](https://developers.google.com/protocol-buffers/) for encode/decode all messages.

```protobuf
syntax = "proto3";

message Message {
  oneof type {
    // INCOMING AND OUTCOMING MESSAGES
    // Server sends `heartbeat` message each 5 seconds and expects getting the
    // same message back. If after 3 tentatives still no response then close the
    // connection.
    // Server sends a heartbeat every 5 seconds and expects to receive it as well. After three missed heartbeats
    bool heartbeat = 1;
    // Any message to be exchanged between two peers.
    // For instance WebRTC offer, answer and candidates.
    Content content = 2;

    // INCOMING MESSAGE
    // Peer either wants to make sure that he is still a group member or wants
    // to become one.
    GroupData connect = 3;

    // OUTCOMING MESSAGE
    // Response to the connect request above. True if the peer is the only member
    // of the group or he is connected to at least one group member. Otherwise the
    // signaling server subscribes this peer to one of the group member (i.e. the
    // content message maybe exchanged) .
    bool connected = 4;
  }
}

message Content {
  uint32 senderId = 1;
  uint32 recipientId = 2;
  bool lastData = 2; // Indicates that this is the last data to be forwarded
  bytes data = 3; // Any data sent by the peer
}

message GroupData {
  uint32 id = 1; // Current peer id in the group
  repeated uint32 members = 2; // Peer's members view. Maybe an empty array.
}
```

Server may close the socket with the following codes:

- **ERR_KEY: 4741** // Inappropriate key format (e.g. key too long)
- **ERR_HEARTBEAT = 4742** // Heart-beats error
- **ERR_MESSAGE = 4743** // Any error due to message: type, format etc.
- **ERR_BLOCKING_MEMBER = 4744** // When only one member left in the group and new peers could not join via him.

---
_Source: https://npm.io/package/sigver · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
