# checkaddy

A simple terminal application for validating and inspecting public cryptocurrency addresses across multiple networks. It performs local format validation and optionally fetches basic address data from public blockchain APIs.

![Demo](assets/demo.gif)

## Features

- Local validation for several address formats
- Support for both UTXO and EVM chains
- Fetches balance and transaction metadata from public endpoints
- Terminal UI built with `textual`
- Optional JSON output for raw data
- Explorer links for quick inspection in a browser

## Supported Networks

- Bitcoin (BTC)
- Litecoin (LTC)
- Dogecoin (DOGE)
- Dash (DASH)
- Bitcoin Cash (BCH)
- Ethereum (ETH)
- BNB Chain (BSC)
- Polygon (MATIC)

## What it Shows

Depending on the network and API availability:

- Confirmed balance
- Unconfirmed balance
- Total received
- Total sent
- Transaction count
- Data source used for the lookup

## Requirements

- Python 3.10+
- `requests`
- `textual`

Install dependencies:

```bash
pip install requests textual
```

## Running

```bash
python run.py
```

Or install the command locally:

```bash
pip install -e .
```

Launch the Textual UI:

```bash
checkaddy
```

Check an address directly in the terminal:

```bash
checkaddy <address> --coin BTC
```

If the address format maps to exactly one supported network, `--coin` can be omitted:

```bash
checkaddy <address>
```

For EVM addresses and legacy formats that can belong to multiple networks, pass the network explicitly:

```bash
checkaddy 0x0000000000000000000000000000000000000000 --coin ETH
checkaddy 0x0000000000000000000000000000000000000000 --coin MATIC --json
```

## Notes

- Only public wallet addresses are supported.
- Private keys or seed phrases should never be entered.
- Some values may be unavailable depending on the limitations of free API endpoints.

## License

This project is licensed under the MIT License. See the `LICENSE` file for details.

Copyright (c) 2026 zv.