@libp2p/http

Accept HTTP requests over libp2p streams and/or use libp2p protocols over HTTP

About

This module allows you to use HTTP requests as a transport for libp2p protocols (libp2p over HTTP), and also libp2p streams as a transport for HTTP requests (HTTP over libp2p).

It integrates with existing Node.js friendly HTTP frameworks such as express and Fastify as well as Request/ Response-based frameworks like Hono.

It even allows creating Node.js-style http.Servers and WebSocketServers in browsers to truly realize the power of the distributed web.

In addition to URL-based addressing, it can use a libp2p PeerId and/or multiaddr(s) and lets libp2p take care of the routing, thus taking advantage of features like multi-routes, NAT traversal and stream multiplexing over a single connection.

Packages

• examples/express-server-over-libp2p How to serve an express app over libp2p streams
• examples/hono-server-over-libp2p undefined
• examples/libp2p-as-http-transport undefined
• examples/libp2p-over-http-server undefined
• examples/peer-id-auth How to authenticate peers over HTTP
• examples/serving-websites-from-web-browsers How to serve websites from web browsers using libp2p
• examples/websockets-over-libp2p How to serve WebSockets over libp2p streams
• packages/http Accept HTTP requests over libp2p streams or use libp2p protocols over HTTP
• packages/http-fetch libp2p-compatible implementation of the fetch API
• packages/http-peer-id-auth An implementation of Peer ID Authentication over HTTP
• packages/http-ping An HTTP version of the ping protocol
• packages/http-server HTTP server components
• packages/http-utils Shared utils and common code for HTTP modules
• packages/http-websocket libp2p-compatible implementation of the WebSocket API
• packages/interop Interop tests for the @libp2p/http collection of modules

API Docs

• https://libp2p.github.io/js-libp2p-http

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.