3 releases (breaking)

new 0.3.0 Mar 19, 2025
0.2.0 Mar 16, 2025
0.1.0 Mar 14, 2025

#4 in #balances

Download history 318/week @ 2025-03-14

318 downloads per month

Custom license

75KB
2K SLoC

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.

Dependencies

~33–50MB
~809K SLoC