* Rename Transport::RawConn to Output * Remove AsyncRead + AsyncWrite bound on Transport::Output * UpgradedNode now always implements Transport * Add and tweak modifiers for Transport and ConnectionUpgrade * Secio upgrade now returns the pubkey in its output * Add upgrade::apply * Add Transport::and_then * Rework the swarm * Rustfmt * Fix concerns
Implementation of the libp2p Transport
trait for Websockets.
See the documentation of swarm
and of libp2p in general to learn how to use the Transport
trait.
This library is used in a different way depending on whether you are compiling for emscripten or for a different operating system.
Emscripten
On emscripten, you can create a BrowserWsConfig
object with BrowserWsConfig::new()
. It can
then be used as a transport.
Listening on a websockets multiaddress isn't supported on emscripten. Dialing a multiaddress
which uses ws
on top of TCP/IP will automatically use the XMLHttpRequest
Javascript object.
use libp2p_websocket::BrowserWsConfig;
let ws_config = BrowserWsConfig::new();
// let _ = ws_config.dial("/ip4/40.41.42.43/tcp/12345/ws".parse().unwrap());
Other operating systems
On other operating systems, this library doesn't open any socket by itself. Instead it must be
plugged on top of another implementation of Transport
such as TCP/IP.
This underlying transport must be put inside a WsConfig
object through the
WsConfig::new()
function.
extern crate libp2p_swarm;
extern crate libp2p_tcp_transport;
extern crate libp2p_websocket;
extern crate tokio_core;
use libp2p_swarm::{Multiaddr, Transport};
use libp2p_tcp_transport::TcpConfig;
use libp2p_websocket::WsConfig;
use tokio_core::reactor::Core;
let core = Core::new().unwrap();
let ws_config = WsConfig::new(TcpConfig::new(core.handle()));
let _ = ws_config.dial("/ip4/40.41.42.43/tcp/12345/ws".parse().unwrap());