Skip to content

woxjro/lazy-etherscan

Repository files navigation

lazy-etherscan

Static Badge build status GitHub

demo

Table of contents

Features

  • No Browser Required - Use it effortlessly even in environments where browsers are unavailable, such as within servers.
  • Developer Friendly - Operate efficiently using keyboard shortcuts.
  • Easily Switch Endpoints - Switch between endpoints, including Mainnet, Testnets, custom node connections, and even BSC endpoints.
  • Rich Search Functionality - You can search by the following words.
    • Address
    • Block Number
    • ENS ID
    • Transaction Hash
    • Ticker Name (USDT, BNB,UNI, ...)

Prerequisites

Optional: Etherscan API Key

To see statistics information about Ethereum, you have to set an Etherscan's free API key. You can get it from here. And add it to your environment variables. If you are using zsh, run the following command.

$ echo 'export ETHERSCAN_API_KEY=XXXXXXXXXXXX' >> ~/.zshenv

To see transactions' decoded input data, you have to preinstall ethereum-input-data-decoder. Please run the following command.

$ npm install -g ethereum-input-data-decoder

Build

This software has been tested and verified to work correctly on the following operating systems:

  • Ubuntu 22.04.2 LTS
  • macOS Ventura 13.2
$ git clone --recursive https://github.com/woxjro/lazy-etherscan
$ cd lazy-etherscan
$ cargo run --

Configurations & Usage

Please check the various settings such as endpoints using the following command:

$ cargo run -- --help

Usage

The basic usage is as follows:

  • Press q to exit lazy-etherscan.
  • Press s to focus on the search bar, where you can perform searches for addresses, blocks, transactions, and more.
  • Press 1 to navigate the "Latest Blocks" panel. Use j to move to a block below and k to an above block.
    • Press r to refresh the "Latest Blocks".
  • Press 2 to navigate the "Latest Transactions" panel. Use j to move to a transaction below and k to move to a transaction above.
    • Press r to refresh the "Latest Transactions".
  • Press <Ctrl+e> to toggle the sidebar.
  • Press <Ctrl+p> to move to a previous screen.

Roadmap

Please see this issue.

Contributing

Any contributions are welcome! Please see CONTRIBUTING.md.

Sponsors

This project has been developed with a grant from the Ethereum Foundation and Gitcoin. ethereum foundation gitcoin

Acknowledgement

lazy-etherscan is written in Rust and is built on top of ratatui. This project is highly inspired by Etherscan, lazygit and spotify-tui.