#tokio #lightning #connection #tcp-stream #wish #sockets #reference

lightning-net-tokio

Implementation of the rust-lightning network stack using Tokio. For Rust-Lightning clients which wish to make direct connections to Lightning P2P nodes, this is a simple alternative to implementing the required network stack, especially for those already using Tokio

44 releases

0.0.125 Oct 14, 2024
0.0.124-rc1 Aug 29, 2024
0.0.123 May 9, 2024
0.0.121 Jan 23, 2024
0.0.1 Jun 1, 2019

#4 in #wish

Download history 2937/week @ 2024-07-25 2701/week @ 2024-08-01 2895/week @ 2024-08-08 2444/week @ 2024-08-15 3220/week @ 2024-08-22 2720/week @ 2024-08-29 2430/week @ 2024-09-05 2568/week @ 2024-09-12 2287/week @ 2024-09-19 2458/week @ 2024-09-26 2191/week @ 2024-10-03 3397/week @ 2024-10-10 3360/week @ 2024-10-17 2156/week @ 2024-10-24 2762/week @ 2024-10-31 2163/week @ 2024-11-07

11,161 downloads per month
Used in 5 crates (4 directly)

MIT/Apache

7MB
114K SLoC

A socket handling library for those running in Tokio environments who wish to use rust-lightning with native TcpStreams.

Designed to be as simple as possible, the high-level usage is almost as simple as "hand over a TcpStream and a reference to a PeerManager and the rest is handled".

The PeerManager, due to the fire-and-forget nature of this logic, must be a reference, (e.g. an [Arc]) and must use the SocketDescriptor provided here as the PeerManager's SocketDescriptor implementation.

Three methods are exposed to register a new connection for handling in tokio::spawn calls; see their individual docs for details.

Dependencies

~10–18MB
~186K SLoC