feat: add websocket transport for browser environment based on web-sys

CHANGELOG.md

@@ -31,10 +31,11 @@
 - [`libp2p-pnet` CHANGELOG](transports/pnet/CHANGELOG.md)
 - [`libp2p-quic` CHANGELOG](transports/quic/CHANGELOG.md)
 - [`libp2p-tcp` CHANGELOG](transports/tcp/CHANGELOG.md)
+- [`libp2p-tls` CHANGELOG](transports/tls/CHANGELOG.md)
 - [`libp2p-uds` CHANGELOG](transports/uds/CHANGELOG.md)
 - [`libp2p-wasm-ext` CHANGELOG](transports/wasm-ext/CHANGELOG.md)
 - [`libp2p-websocket` CHANGELOG](transports/websocket/CHANGELOG.md)
-- [`libp2p-tls` CHANGELOG](transports/tls/CHANGELOG.md)
+- [`libp2p-websys-websocket` CHANGELOG](transports/websys-websocket/CHANGELOG.md)
 
 ## Multiplexers
 

Cargo.toml

@@ -53,6 +53,7 @@ members = [
     "transports/wasm-ext",
     "transports/webrtc",
     "transports/websocket",
+    "transports/websys-websocket",
 ]
 resolver = "2"
 

libp2p/CHANGELOG.md

@@ -8,10 +8,15 @@
 ## 0.51.3
 
 - Deprecate the `mplex` feature.
-The recommended baseline stream multiplexer is `yamux`.
-See [PR 3689].
+  The recommended baseline stream multiplexer is `yamux`.
+  See [PR 3689].
+
+- Introduce `libp2p::websys_websocket` module behind `websys-websocket` feature flag.
+  This supersedes the existing `libp2p::wasm_ext` module which is now deprecated.
+  See [PR 3679].
 
 [PR 3689]: https://github.com/libp2p/rust-libp2p/pull/3689
+[PR 3679]: https://github.com/libp2p/rust-libp2p/pull/3679
 
 ## 0.51.2
 

libp2p/Cargo.toml

@@ -46,6 +46,7 @@ full = [
     "wasm-bindgen",
     "wasm-ext",
     "wasm-ext-websocket",
+    "websys-websocket",
     "webrtc",
     "websocket",
     "yamux",
@@ -85,6 +86,7 @@ uds = ["dep:libp2p-uds"]
 wasm-bindgen = ["futures-timer/wasm-bindgen", "instant/wasm-bindgen", "getrandom/js", "libp2p-swarm/wasm-bindgen"]
 wasm-ext = ["dep:libp2p-wasm-ext"]
 wasm-ext-websocket = ["wasm-ext", "libp2p-wasm-ext?/websocket"]
+websys-websocket = ["dep:libp2p-websys-websocket"]
 webrtc = ["dep:libp2p-webrtc", "libp2p-webrtc?/pem"]
 websocket = ["dep:libp2p-websocket"]
 yamux = ["dep:libp2p-yamux"]
@@ -116,8 +118,8 @@ libp2p-rendezvous = { workspace = true, optional = true }
 libp2p-request-response = { workspace = true, optional = true }
 libp2p-swarm = { workspace = true }
 libp2p-wasm-ext = { workspace = true, optional = true }
+libp2p-websys-websocket = { version = "0.1.0", path = "../transports/websys-websocket", optional = true }
 libp2p-yamux = { workspace = true, optional = true }
-
 multiaddr = { version = "0.17.0" }
 pin-project = "1.0.0"
 

libp2p/src/lib.rs

@@ -141,8 +141,16 @@ pub use libp2p_tls as tls;
 #[doc(inline)]
 pub use libp2p_uds as uds;
 #[cfg(feature = "wasm-ext")]
+#[deprecated(
+    note = "`wasm-ext` is deprecated and will be removed in favor of `libp2p-websys-websocket`."
+)]
+pub mod wasm_ext {
+    #[doc(inline)]
+    pub use libp2p_wasm_ext::*;
+}
+#[cfg(feature = "websys-websocket")]
 #[doc(inline)]
-pub use libp2p_wasm_ext as wasm_ext;
+pub use libp2p_websys_websocket as websys_websocket;
 #[cfg(feature = "webrtc")]
 #[cfg_attr(docsrs, doc(cfg(feature = "webrtc")))]
 #[cfg(not(target_arch = "wasm32"))]

transports/websys-websocket/CHANGELOG.md

@@ -0,0 +1,3 @@
+# 0.1.0 - unreleased
+
+- Add Websys Websocket transport.

transports/websys-websocket/Cargo.toml

@@ -0,0 +1,33 @@
+[package]
+name = "libp2p-websys-websocket"
+edition = "2021"
+rust-version = "1.60.0"
+description = "libp2p websocket transports for WASM browser runtime."
+version = "0.1.0"
+authors = ["Vince Vasta <[email protected]>"]
+license = "MIT"
+repository = "https://github.com/libp2p/rust-libp2p"
+keywords = ["peer-to-peer", "libp2p", "networking"]
+categories = ["network-programming", "asynchronous"]
+
+[dependencies]
+futures = "0.3.26"
+js-sys = "0.3.61"
+libp2p-core = { version = "0.39", path = "../../core" }
+parking_lot = "0.12.1"
+send_wrapper = "0.6.0"
+thiserror = "1.0.38"
+wasm-bindgen = "0.2.84"
+web-sys = { version = "0.3.61", features = ["BinaryType", "CloseEvent", "MessageEvent", "WebSocket"] }
+
+[dev-dependencies]
+libp2p-identity = { path = "../../identity" }
+libp2p-noise = { path = "../noise" }
+libp2p-yamux = { path = "../../muxers/yamux" }
+
+# Passing arguments to the docsrs builder in order to properly document cfg's.
+# More information: https://docs.rs/about/builds#cross-compiling
+[package.metadata.docs.rs]
+all-features = true
+rustdoc-args = ["--cfg", "docsrs"]
+rustc-args = ["--cfg", "docsrs"]