Skip to content

kamilsa/litep2p

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1,052 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

litep2p

License Crates.io docs.rs

litep2p is a libp2p-compatible peer-to-peer (P2P) networking library

Features

  • Supported protocols:
    • /ipfs/ping/1.0.0
    • /ipfs/identify/1.0.0
    • /ipfs/kad/1.0.0
    • /ipfs/bitswap/1.2.0
    • Multicast DNS
    • Notification protocol
    • Request-response protocol
    • API for creating custom protocols
  • Supported transports:
    • TCP
    • QUIC
    • WebRTC
    • WebSocket (WS + WSS)

Usage

litep2p has taken a different approach with API design and as such is not a drop-in replacement for rust-libp2p. Below is a sample usage of the library:

use futures::StreamExt; use litep2p::{ config::ConfigBuilder, protocol::{libp2p::ping, request_response::ConfigBuilder as RequestResponseConfigBuilder}, transport::{quic::config::Config as QuicConfig, tcp::config::Config as TcpConfig}, Litep2p, ProtocolName, }; // simple example which enables `/ipfs/ping/1.0.0` and `/request/1` protocols // and TCP and QUIC transports and starts polling events #[tokio::main] async fn main() { // enable IPFS PING protocol let (ping_config, mut ping_event_stream) = ping::Config::default(); // enable `/request/1` request-response protocol let (req_resp_config, mut req_resp_handle) = RequestResponseConfigBuilder::new(ProtocolName::Static("/request/1")) .with_max_size(1024) .build(); // build `Litep2pConfig` object let config = ConfigBuilder::new() .with_tcp(TcpConfig { listen_addresses: vec![ "/ip6/::1/tcp/0".parse().expect("valid address"), "/ip4/127.0.0.1/tcp/0".parse().expect("valid address"), ], ..Default::default() }) .with_quic(QuicConfig { listen_addresses: vec!["/ip4/127.0.0.1/udp/0/quic-v1" .parse() .expect("valid address")], ..Default::default() }) .with_libp2p_ping(ping_config) .with_request_response_protocol(req_resp_config) .build(); // build `Litep2p` object let mut litep2p = Litep2p::new(config).unwrap(); loop { tokio::select! { _event = litep2p.next_event() => {}, _event = req_resp_handle.next() => {}, _event = ping_event_stream.next() => {}, } } }

Seeexamples for more details on how to use the library

Copying

MIT license

About

Peer-to-peer networking library

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages

  • Rust 99.8%
  • Shell 0.2%