What is Chainsaw

Chainsaw is an interactive TUI tool to fetch and export on-chain transactions for Bitcoin and Ethereum wallets — directly from your terminal, with no API key required.

Features

• Auto-detection – Detects the chain automatically from the address format (BTC / ETH).
• Live address validation – Validates addresses in real time via public APIs.
• Custom date range – Filter transactions by start and end date.
• Fetch limit – Optionally limit the number of pages (BTC) or transactions (ETH) fetched.
• CSV export – Exports a clean CSV file with all transaction data.
• Terminal display – Shows a summary and transaction timeline directly in the terminal.
• Zero configuration – Works out of the box, no setup needed.

Supported chains

• ₿ Bitcoin (BTC) – via Blockstream.info  |  Formats: 1... / 3... / bc1...
• Ξ Ethereum (ETH) – via Blockscout.com  |  Format: 0x... (42 hex chars)

Installation

git clone https://github.com/vladkotov92/chainsaw.git
cd chainsaw
pip install requests

Usage

python3 chainsaw.py

Follow the interactive steps in the terminal:

STEP 1 — Enter wallet address      (chain detected automatically)
STEP 2 — Set date range            (mm/dd/yyyy)
STEP 3 — Set fetch limit           (optional: max pages / transactions)
STEP 4 — Review & confirm

CSV output

Reports are saved in the current directory with the format:
btc_report_<wallet>_<from>_<to>.csv / eth_report_<wallet>_<from>_<to>.csv

BTC columns: n, date_time, txid, block_height, type, received_btc, sent_btc, amount_btc, fee_btc, from, to

ETH columns: n, date_time, txhash, block, type, amount_eth, from, to, fee_eth, gas_used, gas_price_gwei, status, method

Privacy

• All API calls are read-only
• No data is stored or sent anywhere
• Only public blockchain APIs are used

Release notes