webpeerjs

WebPEER is a novel decentralized P2P network inside browser with a chance of working. πŸ”₯

MIT License

Downloads
977
Stars
3
Committers
2

WebPEER.js

Decentralized P2P JS library for communication between applications in browser.

WebPEER.js enables browser to browser connectivity without a central server. Build completely peer-to-peer web applications, no trackers or relay servers required. Connecting projects safely, privately, and reliably in WebPEER Network.

Basic Connection Demo - https://nuzulul.github.io/webpeerjs/demo/

Security

WebPEER Network run over libp2p gossipsub protocol to enables communication between peers.

By default, the gossipsub implementation will sign all messages with the author’s private key, and require a valid signature before accepting or propagating a message further. This prevents messages from being altered in flight, and allows recipients to authenticate the sender.

However, as a cooperative protocol, it may be possible for peers to interfere with the message routing algorithm in a way that disrupts the flow of messages through the network.

Features

  • βœ… Decentralized P2P
  • βœ… Scalable Peers
  • βœ… Works in Browsers
  • βœ… Broadcast Messages
  • βœ… Censorship Resistant

Browser Support

Chrome Firefox Opera Edge Brave Safari
Latest βœ” Latest βœ” Latest βœ” Latest βœ” Latest βœ” Latest ❓

Quickstart

Try now in Playground :

https://jsbin.com/suwesaliro/1/edit?html,output

NPM install:

npm i webpeerjs

Browser <script> tag :

Uses built-in JS files from latest release or CDN will make it's exports available as webpeerjs in the global namespace.

<script src="https://cdn.jsdelivr.net/npm/[email protected]/dist/umd/webpeerjs.min.js"></script>

Example

import { webpeerjs } from 'webpeerjs'

void async function main() {

	const node = await webpeerjs.createWebpeer()
	
	console.log(`My node id : ${node.id}`)
	
	const [broadcast,listen,members] = node.joinRoom('globalroom')
	
	listen((message,id) => {
		console.log(`Message from ${id} : ${message}`)
	})
	
	members((data) => {
		console.log(`Members : ${data}`)
		broadcast('hello')
	})
	
}()

API

  • createWebpeer(config) - Create a new node.
    • config - Configuration object contain:
      • rtcConfiguration - (optional) Custom rtcConfiguration for WebRTC transport, the only transport available for direct peer-to-peer connectivity between browser.
  • id - The unique ID of the node as an identity in the global network.
  • status - Get the node status, returns connected or unconnected.
  • peers - Get all connected peers.
  • joinRoom(namespace) - Join to the room, returns an array of three functions (Broadcaster, onListenBroadcast, onMembersUpdate).

API Docs

https://nuzulul.github.io/webpeerjs

License

MIT

Maintainers

Nuzulul Zulkarnain

Package Rankings
Top 29.25% on Npmjs.org
Related Projects