@libp2p/webrtc-direct

⚠️⚠️⚠️⚠️⚠️⚠️

Status:

Archived and not maintained

Alternatives:

WebRTC Browser-to-Server is being implemented in js-libp2p and tracked here https://github.com/libp2p/js-libp2p/issues/1478 per the specification: https://github.com/libp2p/specs/pull/412

WebRTC Browser-to-Browser is being tracked here: https://github.com/libp2p/js-libp2p/issues/1462

Questions:

Please direct any questions about the specification to: https://github.com/libp2p/specs/issues

Please direct any questions about the js-libp2p WebRTC implementations to: https://github.com/libp2p/js-libp2p/issues/1478 or https://github.com/libp2p/js-libp2p/issues/1462

⚠️⚠️⚠️⚠️⚠️⚠️

@libp2p/webrtc-direct

Dial using WebRTC without the need to set up any Signalling Rendezvous Point!

Table of contents

• Install
  • Browser <script> tag
• Usage
• API
  • Transport
  • Connection
• Contribute
• License
• Contribution

Install

$ npm i @libp2p/webrtc-direct

Browser <script> tag

Loading this module through a script tag will make it's exports available as Libp2pWebrtcDirect in the global namespace.

<script src="https://unpkg.com/@libp2p/webrtc-direct/dist/index.min.js"></script>

NOTE: To run build scripts node-pre-gyp is required. You can install it by running npm install -g node-pre-gyp.

Usage

import { createLibp2p } from 'libp2p'
import { webRTCDirect } from '@libp2p/webrtc-direct'

const node = await createLibp2p({
  transports: [
    webRTCDirect()
  ]
  //... other config
})
await node.start()
await node.dial('/ip4/127.0.0.1/tcp/9090/http/p2p-webrtc-direct')

API

Transport

Connection

Contribute

The libp2p implementation in JavaScript is a work in progress. As such, there are a few things you can do right now to help out:

• Go through the modules and check out existing issues. This would be especially useful for modules in active development. Some knowledge of IPFS/libp2p may be required, as well as the infrastructure behind it - for instance, you may need to read up on p2p and more complex operations like muxing to be able to help technically.
• Perform code reviews.
• Add tests. There can never be enough tests.

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.