blockrs

Crates.ioblockrs
lib.rsblockrs
version0.4.0
created_at2025-03-14 00:50:39.293729+00
updated_at2025-03-31 06:16:10.077874+00
descriptionTUI for tailing chain data
homepage
repositoryhttps://github.com/sergerad/blockrs
max_upload_size
id1591687
size221,188
Serge Radinovich (sergerad)

documentation

README

Blockrs

Blockrs is a TUI for observing chain data.

alt text

Installation

Use cargo to install the crate:

cargo install blockrs
blockrs -h

Usage

Currently only supports Ethereum RPC:

blockrs https://rpc.flashbots.net

If you want to watch account balances, you need to provide a list via the config file. For example:

cat <<EOF > /tmp/config.yaml
tick_rate: 5s
addresses:
  - 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045
EOF
export BLOCKRS_CONFIG=/tmp/
blockrs https://rpc.flashbots.net

User Input

The app will run in a mode which follows the HEAD of the chain by default.

If you hit j/k/Up/Down at any time, the app will stop following head and allow you to observe any previously-processed block.

To re-enter follow mode, hit f/Space/Enter.

Roadmap

The following features are required for 1.0:

  1. Interactive mode (stop tail, select block)
  2. Add implementations for other ChainProvider instances beyond Ethereum RPC

Acknowledgements

Ratatui is a fantastic crate for creating TUI applications in Rust. This project is based on its template found here.

Commit count: 51

cargo fmt