/yaeth-cli

CLI wrapper around ethers-rs to query the ethereum blockchain from the terminal

Primary LanguageRustMIT LicenseMIT

yaeth-cli (yet another ethereum cli)

yaeth-cli is a command-line interface (CLI) tool written in Rust that serves as a wrapper around ethers-rs, and uses the clap crate for command-line argument parsing, enabling users to query the Ethereum blockchain from a terminal.

This is a toy project intended to further improve my Rust knowledge and explore the Ethereum JSON-RPC spec.

Overview

An ether-rs wrapper to query the ethereum blockchain from a terminal

Usage: yaeth [OPTIONS] <COMMAND>

Commands:
  block
          Execute block related operations
  account
          Execute account related operations
  transaction
          Execute transaction related operations
  event
          Execute event related operations
  gas
          Execute gas related operations
  utils
          Collection of utils

Options:
  -p, --priv-key <PRIV_KEY>
          Private key to use for signing transactions

  -r, --rpc-url <RPC_URL>
          Rpc url to send requests to

  -o, --out <OUT>
          Output format for the cli result
          
          [default: console]

          Possible values:
          - console: Output the cli result to the terminal
          - json:    Output the cli result to a json file

  -f, --file <FILE>
          Optional name for the output file
          
          [default: out]

  -c, --config-file <CONFIG_FILE>
          Optional configuration file

  -h, --help
          Print help (see a summary with '-h')

  -V, --version

Installation

To try yaeth-cli, follow these steps:

  1. Clone the repository to your local machine.
  2. Install Rust and Cargo, if you haven't already, following the guide.
  3. Navigate to the cloned yaeth-cli directory in your terminal.
  4. Run the following command to build and install yaeth-cli:
cargo install --path .

Examples

Get transaction data:

yaeth --config-file=mainnet-config.json transaction --hash=0x79202697c177e951ea2bdfc283ef9a44108c41e2023cf56c4fd233a589da2e6a get

Query account balance:

yaeth --config-file=mainnet-config.json account --ens=vitalik.eth balance

Get block data:

yaeth --config-file=mainnet-config.json block --number=17081411 get

Work in progress

  • Block:

    • eth_blockNumber
    • eth_getBlockByHash
    • eth_getBlockByNumber
    • eth_getBlockReceipts
    • eth_getBlockTransactionCountByHash
    • eth_getBlockTransactionCountByNumber
    • eth_getUncleCountByBlockHash
    • eth_getUncleCountByBlockNumber

  • Transaction

    • eth_call
    • eth_getTransactionByBlockHashAndIndex
    • eth_getTransactionByBlockNumberAndIndex
    • eth_getTransactionByHash
    • eth_getTransactionReceipt
    • eth_sendRawTransaction
    • eth_sendTransaction

  • Account

    • eth_getBalance
    • eth_getCode
    • eth_getStorageAt
    • eth_getTransactionCount

  • Gas

    • eth_estimateGas
    • eth_feeHistory
    • eth_gasPrice
    • eth_maxPriorityFeePerGas

  • Utils

    • eth_accounts
    • eth_chainId
    • eth_getProof
    • eth_protocolVersion
    • eth_sign
    • eth_syncing

  • Event / Logs

    • eth_getFilterChanges
    • eth_getFilterLogs
    • eth_getLogs
    • eth_newBlockFilter
    • eth_newFilter
    • eth_newPendingTransactionFilter
    • eth_pendingTransactions
    • eth_uninstallFilter

License

yaeth-cli is released under the MIT License. See LICENSE for details.

Acknowledgements

Special thanks to the developers of ethers-rs and clap for their work.