webrtc-star-protocol

@libp2p/webrtc-star-protocol

shared types used by the libp2p webrtc transport and signalling server

Table of contents

• Install
• Description
• Protocol
• License
• Contribution

Install

$ npm i @libp2p/webrtc-star-protocol

Description

This module contains type definitions for the websocket events that are exchanged between peers during the handshake process.

Protocol

1. Peers connect to the same signal server and send an ss-join event with their multiaddr as a string
2. Peers send one or more ss-handshake events with candidate signals
3. Peers receive one or more ws-handshake events with candidate signals
4. Peers send one ss-handshake event with an offer signal
5. Peers receive one ws-handshake events with an offer signal
6. Peers are now connected
7. Peers receive one or more ws-peer events with a multiaddr as a string for peer discovery
8. Peers send an ss-leave event or disconnect when hanging up

See ./src/index.ts for definitions of ss-handshake and ws-handshake payloads.

License

Licensed under either of

• Apache 2.0, (LICENSE-APACHE / http://www.apache.org/licenses/LICENSE-2.0)
• MIT (LICENSE-MIT / http://opensource.org/licenses/MIT)

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.