#block-header #chain #data-block #lightning #sync #source #fetch

lightning-block-sync

Utilities to fetch the chain data from a block source and feed them into Rust Lightning

36 releases

0.0.123 May 9, 2024
0.0.123-beta Apr 19, 2024
0.0.121 Jan 23, 2024
0.0.119 Dec 16, 2023
0.0.13 Mar 9, 2021

#8 in #data-block

Download history 455/week @ 2024-01-29 601/week @ 2024-02-05 186/week @ 2024-02-12 551/week @ 2024-02-19 289/week @ 2024-02-26 647/week @ 2024-03-04 561/week @ 2024-03-11 569/week @ 2024-03-18 756/week @ 2024-03-25 782/week @ 2024-04-01 623/week @ 2024-04-08 526/week @ 2024-04-15 724/week @ 2024-04-22 663/week @ 2024-04-29 828/week @ 2024-05-06 495/week @ 2024-05-13

2,729 downloads per month
Used in rgb-lightning-sample

MIT/Apache

6.5MB
108K SLoC

A lightweight client for keeping in sync with chain activity.

Defines an SpvClient utility for polling one or more block sources for the best chain tip. It is used to notify listeners of blocks connected or disconnected since the last poll. Useful for keeping a Lightning node in sync with the chain.

Defines a BlockSource trait, which is an asynchronous interface for retrieving block headers and data.

Enabling feature rest-client or rpc-client allows configuring the client to fetch blocks using Bitcoin Core's REST or RPC interface, respectively.

Both features support either blocking I/O using std::net::TcpStream or, with feature tokio, non-blocking I/O using tokio::net::TcpStream from inside a Tokio runtime.

Dependencies

~7–16MB
~148K SLoC