JordanNewell/crypto-key-classifier

<p align="center" <img src="https://raw.githubusercontent.com/JordanNewell/crypto-key-classifier/main/assets/hero.png" alt="crypto-key-classifier — Classify any crypto-key string (BTC/ETH/SOL/Cosmos + ~50 chains). Aggressive recovery from corruption, bad checksums, OCR noise." width="100%" <br <a href="https://pypi.org/project/crypto-key-classifier/"<img src="https://img.shields.io/pypi/v/crypto-key-classifier?logo=pypi&logoColor=white" alt="PyPI version"</a <a href="https://pypi.org/project/crypto-key-classifier/"<img src="https://img.shields.io/pypi/pyversions/crypto-key-classifier?logo=python&logoColor=white" alt="Python versions"</a <a href="./LICENSE"<img src="https://img.shields.io/pypi/l/crypto-key-classifier?color=blue" alt="License: MIT"</a <a href="https://github.com/JordanNewell/crypto-key-classifier/actions/workflows/ci.yml"<img src="https://github.com/JordanNewell/crypto-key-classifier/actions/workflows/ci.yml/badge.svg" alt="CI"</a <a href="https://github.com/JordanNewell/crypto-key-classifier/releases"<img src="https://img.shields.io/badge/release-0.6.1-blue </p

crypto-key-classifier (classify-key / ckc)

Classify any plausible crypto-key string — BTC / ETH / SOL / Cosmos family + a dozen more chains, plus BIP-39 and Electrum mnemonics — with aggressive recovery from formatting noise, bad checksums, wrong encodings, and OCR corruption. Recommends compatible wallets and enumerates cross-chain re-encodings for shared-key families (Cosmos IBC, EVM L2s, BTC forks, Polkadot SS58).

Status: v0.6.1-pypi, shipped. 239 tests, 17 validators covering ~50 chains, hypothesis fuzz suite.

Why

If you've ever stared at a string like 0x7c13fff2d7e8... or bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh and wondered "is this an address or a private key? which chain? is the checksum valid?" — this tool answers that, fast, locally, and without leaking the key to a lookup service.

Built for the recovery / forensics / support-ticket triage case: someone hands you a string and you need to (a) figure out what it is, (b) tell them what wallets will accept it, and (c) cross-check it against related chains they might also own.

Install

pip install crypto-key-classifier

classify-key --help

Requires Python ≥ 3.10. Dependencies: base58, pycryptodome.

Development install

For hacking on the source:

git clone https://github.com/JordanNewell/crypto-key-classifier.git
cd crypto-key-classifier
pip install -e ".[dev]"   # adds pytest, hypothesis, ruff, pyright

In action

<p align="center" <img src="https://raw.githubusercontent.com/JordanNewell/crypto-key-classifier/main/assets/terminal.png" alt="crypto-key-classifier in action — ETH address classified + cross-chain re-encodings, then corrupted BTC address with OCR whitespace stripped via --explain repair trace" width="100%" </p

Usage

# Classify one key — rich multi-line output (default for single input)
classify-key 0x7c13fff2d7e8b1f7b8e1d8a1f3c5b8a1f3c5b8a1

# Batch — one-line-per-key (default for 2+ inputs)
classify-key addr1.txt addr2.txt
classify-key --file keys.txt
cat keys.txt | classify-key

# JSON for scripting — pipe to jq
classify-key --json addr.txt | jq '.[] | .best_guess'

# Narrow to specific chains

Filter low-confidence matches