cryptochecker

v1.0.1

Published

2 months ago

Multi-chain cryptocurrency address derivation and balance checker - supports 24 blockchains including Bitcoin, Ethereum, Solana, and more

0High
0Medium
0Low

asimdelal

cryptocurrency wallet bitcoin ethereum solana tron cosmos polkadot cardano blockchain address balance mnemonic bip39 cli

🔐 CryptoChecker

Multi-chain cryptocurrency address derivation and balance checker. Supports 24 blockchain networks from private keys or mnemonic phrases.

Quick Start

# Install globally
npm install -g cryptochecker

# Derive addresses from mnemonic
cryptocheck "abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon about"

# Check balances
cryptocheck "your mnemonic" --check

# Show help
cryptocheck --help

Features

Multi-chain support: Bitcoin, Litecoin, Dogecoin, Ethereum, BSC, Polygon, Arbitrum, Optimism, Avalanche, Fantom, Base, zkSync, Linea, Solana, Tron, Cosmos, Aptos, Sui, TON, Near, Polkadot, XRP, Stellar, Cardano
Multiple key formats: Hex, WIF (Bitcoin), Base58 (Solana), JSON byte array (Solana)
Mnemonic support: Derive addresses from 12-24 word seed phrases (works with ALL chains)
Multiple derivation paths: MetaMask, Ledger, Phantom, Solflare, TronLink compatible
Multi-account derivation: Generate addresses for multiple account indices
Auto-detection: Automatically detects input type (mnemonic, hex, WIF, base58, JSON array)
Balance checking: Query native token balances across all networks
Explorer links: Direct links to block explorers for each address
Private key export: Show private keys with --show-keys flag
Beautiful CLI: Color-coded, organized output with helpful error messages

Installation

Option 1: npm (Recommended)

# Install globally via npm
npm install -g cryptochecker

# Now use anywhere
cryptocheck "your mnemonic phrase"
cryptocheck --help

Option 2: npx (No Install)

# Run directly without installing
npx cryptochecker "your mnemonic phrase"
npx cryptochecker --help

Option 3: From Source

# Install Bun if you don't have it
curl -fsSL https://bun.sh/install | bash

# Add Bun to your PATH (add to ~/.zshrc or ~/.bashrc for persistence)
export PATH="$HOME/.bun/bin:$PATH"

# Clone and install
git clone https://github.com/yourusername/cryptochecker.git
cd cryptochecker
bun install

# Run from source
cryptocheck "your mnemonic"

Troubleshooting

If you get command not found: bun after installation:

# Option 1: Add to current session
export PATH="$HOME/.bun/bin:$PATH"

# Option 2: Add permanently to ~/.zshrc (macOS/Linux with zsh)
echo 'export PATH="$HOME/.bun/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

# Option 3: Add permanently to ~/.bashrc (Linux with bash)
echo 'export PATH="$HOME/.bun/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

Supported Input Formats

| Format | Example | Supported Chains | |--------|---------|------------------| | Mnemonic (12-24 words) | abandon abandon ... about | ALL 24 chains ✓ | | Hex key (64 chars) | afdfd9c3d209... | EVM, Tron, Bitcoin, Cosmos | | WIF Compressed (K/L prefix) | KwDiBf89QgGbj... | Bitcoin (all address types) | | WIF Uncompressed (5 prefix) | 5HpHagT65TZzG... | Bitcoin (legacy only) | | Solana Base58 (~87-88 chars) | 27npWoNE4Hfm... | Solana | | Solana JSON Array (64 bytes) | [55, 223, 87, ...] | Solana |

Usage

Note: If installed via npm, use cryptocheck. If running from source, use cryptocheck.

From Mnemonic (Recommended - All Chains)

# Derive addresses from mnemonic (quote the phrase!)
cryptocheck "abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon about"

# Derive multiple accounts
cryptocheck "your mnemonic phrase" --accounts 5

# Show private keys in output
cryptocheck "your mnemonic phrase" --show-keys

# Generate 100 EVM addresses
cryptocheck "mnemonic" --accounts 100 --type evm --compact

# JSON output for bulk processing
cryptocheck "mnemonic" --accounts 100 --type evm --json > addresses.json

# Use all derivation paths (not just standard)
cryptocheck "mnemonic" --accounts 5 --all-paths

# Show derivation paths in output
cryptocheck "mnemonic phrase" --paths

From Hex Private Key (EVM, Tron, Bitcoin, Cosmos)

# Derive addresses from hex private key
cryptocheck afdfd9c3d2095ef696594f6cedcae59e72dcd697e2a7521b1578140422a4f890

# With 0x prefix (also works)
cryptocheck 0xafdfd9c3d2095ef696594f6cedcae59e72dcd697e2a7521b1578140422a4f890

# Check balances
cryptocheck <hex_key> --check

From Bitcoin WIF Key

# Compressed WIF (starts with K or L)
cryptocheck KwDiBf89QgGbjEhKnhXJuH7LrciVrZi3qYjgd9M7rFU73sVHnoWn

# Uncompressed WIF (starts with 5) - legacy addresses only
cryptocheck 5HueCGU8rMjxEXxiPuD5BDku1p3BYjbgkOMyvFihDVZGmgJ8g3z

From Solana Keys

# Base58 encoded keypair (64 bytes)
cryptocheck 27npWoNE4HfmLeQo1TyWcW7NEA28qnsnDK7kcttDQEWrCWnro83HMJ97rMmpvYYZRwDAvG4KRuB7hTBacvwD7bgi

# JSON byte array (from Solana CLI)
cryptocheck '[55, 223, 87, 59, 58, 196, 173, 91, 82, 46, 6, 78, 37, 182, 62, 161, 107, 203, 231, 157, 68, 158, 129, 160, 38, 141, 16, 71, 148, 139, 180, 69, 240, 54, 39, 98, 70, 167, 91, 157, 227, 52, 158, 212, 43, 21, 226, 50, 246, 81, 143, 194, 15, 95, 205, 79, 29, 100, 232, 31, 155, 210, 88, 247]'

Filtering

# Filter by chain type
cryptocheck <input> --type evm
cryptocheck <input> --type solana
cryptocheck <input> --type bitcoin

# Filter by specific network
cryptocheck <input> --network ethereum
cryptocheck <input> --network cosmos --check

# Compact output (addresses only)
cryptocheck <input> --compact

Balance Checking

# Check all networks
cryptocheck "mnemonic" --check

# Check specific network
cryptocheck "mnemonic" --network ethereum --check

# If you have SSL/VPN issues, use --insecure
cryptocheck "mnemonic" --check --insecure

Example Output

From Mnemonic (All 24 Chains)

$ cryptocheck "abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon about"

╔═══════════════════════════════════════════════════════════════════════════════╗
║                             CRYPTO CHECKER                                    ║
║                    Multi-Chain Address & Balance Tool                          ║
╚═══════════════════════════════════════════════════════════════════════════════╝

Input: Mnemonic - abandon abandon abandon... (12 words)

═══ EVM ═══
Address: 0x9858EfFD232B4033E47d90003D41EC34EcaEda94
Path: m/44'/60'/0'/0/0
Networks: Ethereum, BNB Smart Chain, Polygon, Arbitrum One, Optimism, Avalanche C-Chain, Fantom, Base, zkSync Era, Linea
Explorer: https://etherscan.io/address/0x9858EfFD232B4033E47d90003D41EC34EcaEda94

═══ SOLANA ═══
Address: HAgk14JpMQLgt6rVgv7cBQFJWFto5Dqxi472uT3DKpqk
Path: m/44'/501'/0'/0'
Explorer: https://solscan.io/account/HAgk14JpMQLgt6rVgv7cBQFJWFto5Dqxi472uT3DKpqk

═══ TRON ═══
Address: TUEZSdKsoDHQMeZwihtdoBiN46zxhGWYdH
Path: m/44'/195'/0'/0/0
Explorer: https://tronscan.org/#/address/TUEZSdKsoDHQMeZwihtdoBiN46zxhGWYdH

═══ BITCOIN ═══
Address: bc1qcr8te4kr609gcawutmrza0j4xv80jy8z306fyu (native-segwit)
Path: m/84'/0'/0'/0/0
Explorer: https://mempool.space/address/bc1qcr8te4kr609gcawutmrza0j4xv80jy8z306fyu

═══ LITECOIN ═══
Address: ltc1qjmxnz78nmc8nq77wuxh25n2es7rzm5c2rkk4wh
Path: m/84'/2'/0'/0/0

═══ DOGECOIN ═══
Address: DBus3bamQjgJULBJtYXpEzDWQRwF5iwxgC
Path: m/44'/3'/0'/0/0

═══ COSMOS ═══
Address: cosmos19rl4cm2hmr8afy4kldpxz3fka4jguq0auqdal4
Path: m/44'/118'/0'/0/0

═══ APTOS ═══
Address: 0x3266a0c1551ea9e1be76f7b63c1a363ded474ddfb27f8936ce80262d1a46ba16
Path: m/44'/637'/0'/0'/0'

═══ SUI ═══
Address: 0x2b1aac295f85468dba6f273c8cc31baafe610e9a0664f0b3a4f654dbbaa8b750
Path: m/44'/784'/0'/0'/0'

═══ TON ═══
Address: UQE27pKscFQimNbkxi3bMcq9t2QeXE16CzPiRHFPukjFPV
Path: m/44'/607'/0'

═══ NEAR ═══
Address: 5510e2b44cae6eb807e3e0e45d579dda058c274abcba15e5cb84636f5d1ee412
Path: m/44'/397'/0'

═══ POLKADOT ═══
Address: 16Cxg5cRcKgqJLFNHHNZXoGWApyssUCJLkcqWMXEw5zJp
Path: m/44'/354'/0'/0/0

═══ XRP ═══
Address: rHsMGQEkVNJmpGWs8XUBoTBiAAbwxZN5v3
Path: m/44'/144'/0'/0/0

═══ STELLAR ═══
Address: GB3JDWCQJCWMJ3IILWIGDTQJJC5567PGVEVXSCVPEQOTDN64VJBDQBYX
Path: m/44'/148'/0'

═══ CARDANO ═══
Address: addr1g4phx8dg8fedld0zw4jrfrhsde5f5xwmc8tjw8g8p8wycnc9n0z
Path: m/44'/1815'/0'

From Bitcoin WIF Key

$ cryptocheck KwDiBf89QgGbjEhKnhXJuH7LrciVrZi3qYjgd9M7rFU73sVHnoWn

╔═══════════════════════════════════════════════════════════════════════════════╗
║                             CRYPTO CHECKER                                    ║
║                    Multi-Chain Address & Balance Tool                          ║
╚═══════════════════════════════════════════════════════════════════════════════╝

Input: Bitcoin WIF Key - KwDiBf89...3sVHnoWn

═══ BITCOIN ═══
Address: 1BgGZ9tcN4rm9KBzDn7KprQz87SZ26SAMH (legacy)
Explorer: https://mempool.space/address/1BgGZ9tcN4rm9KBzDn7KprQz87SZ26SAMH

Address: bc1qw508d6qejxtdg4y5r3zarvary0c5xw7kv8f3t4 (native-segwit)
Explorer: https://mempool.space/address/bc1qw508d6qejxtdg4y5r3zarvary0c5xw7kv8f3t4

Address: 3JvL6Ymt8MVWiCNHC7oWU6nLeHNJKLZGLN (segwit)
Explorer: https://mempool.space/address/3JvL6Ymt8MVWiCNHC7oWU6nLeHNJKLZGLN

Address: bc1pmfr3p9j00pfxjh0zmgp99y8zftmd3s5pmedqhyptwy6lm87hf5sspknck9 (taproot)
Explorer: https://mempool.space/address/bc1pmfr3p9j00pfxjh0zmgp99y8zftmd3s5pmedqhyptwy6lm87hf5sspknck9

From Solana Base58 Key

$ cryptocheck 27npWoNE4HfmLeQo1TyWcW7NEA28qnsnDK7kcttDQEWrCWnro83HMJ97rMmpvYYZRwDAvG4KRuB7hTBacvwD7bgi

╔═══════════════════════════════════════════════════════════════════════════════╗
║                             CRYPTO CHECKER                                    ║
║                    Multi-Chain Address & Balance Tool                          ║
╚═══════════════════════════════════════════════════════════════════════════════╝

Input: Solana Base58 Key - 27npWoNE...cvwD7bgi

═══ SOLANA ═══
Address: HAgk14JpMQLgt6rVgv7cBQFJWFto5Dqxi472uT3DKpqk
Explorer: https://solscan.io/account/HAgk14JpMQLgt6rVgv7cBQFJWFto5Dqxi472uT3DKpqk

Compact Output

$ cryptocheck "abandon abandon..." --compact

EVM: 0x9858EfFD232B4033E47d90003D41EC34EcaEda94
SOLANA: HAgk14JpMQLgt6rVgv7cBQFJWFto5Dqxi472uT3DKpqk
TRON: TUEZSdKsoDHQMeZwihtdoBiN46zxhGWYdH
BITCOIN: bc1qcr8te4kr609gcawutmrza0j4xv80jy8z306fyu
LITECOIN: ltc1qjmxnz78nmc8nq77wuxh25n2es7rzm5c2rkk4wh
DOGECOIN: DBus3bamQjgJULBJtYXpEzDWQRwF5iwxgC
COSMOS: cosmos19rl4cm2hmr8afy4kldpxz3fka4jguq0auqdal4
APTOS: 0x3266a0c1551ea9e1be76f7b63c1a363ded474ddfb27f8936ce80262d1a46ba16
SUI: 0x2b1aac295f85468dba6f273c8cc31baafe610e9a0664f0b3a4f654dbbaa8b750
TON: UQE27pKscFQimNbkxi3bMcq9t2QeXE16CzPiRHFPukjFPV
NEAR: 5510e2b44cae6eb807e3e0e45d579dda058c274abcba15e5cb84636f5d1ee412
POLKADOT: 16Cxg5cRcKgqJLFNHHNZXoGWApyssUCJLkcqWMXEw5zJp
XRP: rHsMGQEkVNJmpGWs8XUBoTBiAAbwxZN5v3
STELLAR: GB3JDWCQJCWMJ3IILWIGDTQJJC5567PGVEVXSCVPEQOTDN64VJBDQBYX
CARDANO: addr1g4phx8dg8fedld0zw4jrfrhsde5f5xwmc8tjw8g8p8wycnc9n0z

Derivation Paths

| Chain | Path | Address Type | Wallets | |-------|------|--------------|---------| | Bitcoin | m/84'/0'/0'/0/x | Native SegWit (bc1q...) | Most modern wallets | | Bitcoin | m/49'/0'/0'/0/x | SegWit (3...) | Compatibility | | Bitcoin | m/44'/0'/0'/0/x | Legacy (1...) | Old wallets | | Bitcoin | m/86'/0'/0'/0/x | Taproot (bc1p...) | Cutting edge | | Litecoin | m/84'/2'/0'/0/x | Native SegWit (ltc1q...) | Modern wallets | | Litecoin | m/44'/2'/0'/0/x | Legacy (L...) | Old wallets | | Dogecoin | m/44'/3'/0'/0/x | Legacy (D...) | Standard | | EVM | m/44'/60'/0'/0/x | - | MetaMask, most wallets | | EVM | m/44'/60'/0'/x | - | Ledger Live | | EVM | m/44'/60'/x' | - | Ledger Legacy | | Solana | m/44'/501'/x'/0' | - | Phantom, Solflare | | Solana | m/44'/501'/x' | - | Sollet | | Tron | m/44'/195'/0'/0/x | - | TronLink | | Tron | m/44'/195'/0'/x | - | Ledger | | Cosmos | m/44'/118'/0'/0/x | Bech32 (cosmos1...) | Keplr, Leap | | Aptos | m/44'/637'/x'/0'/0' | 0x... (64 char) | Petra, Martian | | Sui | m/44'/784'/x'/0'/0' | 0x... (64 char) | Sui Wallet | | TON | m/44'/607'/x' | UQ... | Tonkeeper | | Near | m/44'/397'/x' | Hex (implicit) | Near Wallet | | Polkadot | m/44'/354'/0'/0/x | SS58 | Polkadot.js | | XRP | m/44'/144'/0'/0/x | r... | XUMM | | Stellar | m/44'/148'/x' | G... | Lobstr | | Cardano | m/44'/1815'/x' | addr1... (simplified) | Daedalus, Yoroi |

Supported Networks

Bitcoin-like

| Network | Coin Type | Explorer | |---------|-----------|----------| | Bitcoin | BTC | mempool.space | | Litecoin | LTC | blockchair.com/litecoin | | Dogecoin | DOGE | blockchair.com/dogecoin |

EVM (Ethereum Compatible)

| Network | Chain ID | Explorer | |---------|----------|----------| | Ethereum | 1 | etherscan.io | | BNB Smart Chain | 56 | bscscan.com | | Polygon | 137 | polygonscan.com | | Arbitrum | 42161 | arbiscan.io | | Optimism | 10 | optimistic.etherscan.io | | Avalanche | 43114 | snowtrace.io | | Fantom | 250 | ftmscan.com | | Base | 8453 | basescan.org | | zkSync Era | 324 | explorer.zksync.io | | Linea | 59144 | lineascan.build |

Other Chains

| Network | Symbol | Explorer | |---------|--------|----------| | Solana | SOL | solscan.io | | Tron | TRX | tronscan.org | | Cosmos | ATOM | mintscan.io/cosmos | | Aptos | APT | explorer.aptoslabs.com | | Sui | SUI | suiscan.xyz | | TON | TON | tonscan.org | | Near | NEAR | nearblocks.io | | Polkadot | DOT | polkadot.subscan.io | | XRP | XRP | xrpscan.com | | Stellar | XLM | stellarchain.io | | Cardano | ADA | cardanoscan.io |

CLI Options

| Option | Description | |--------|-------------| | --check | Check balances on all networks | | --network <name> | Filter to specific network (e.g., ethereum, bitcoin, cosmos) | | --type <type> | Filter by chain type (evm, solana, tron, bitcoin, etc.) | | --accounts <n> | Number of accounts to derive (e.g., --accounts 100) | | --all-paths | Use all derivation paths (default: standard only when --accounts > 1) | | --paths | Show derivation paths in output | | --show-keys | Show private keys in output (use with caution!) | | --json | Output as JSON (for bulk processing/scripting) | | --compact | Compact output (addresses only) | | --checkers | Show additional checker URLs (DeBank, Zapper, etc.) | | --config <path> | Path to custom config file | | --init-config | Generate sample config file | | --insecure | Disable SSL verification (for VPN/proxy environments) | | --help | Show help |

Custom Checkers & Configuration

Built-in Checkers

Use --checkers to show additional portfolio/explorer links:

| Service | Chains | |---------|--------| | DeBank | EVM | | Zapper | EVM | | Zerion | EVM | | Arkham | EVM, Bitcoin | | Solscan | Solana | | SolanaFM | Solana | | Blockchair | Bitcoin | | TronScan | Tron |

# Show all checkers
cryptocheck "mnemonic" --checkers

# EVM with checkers
cryptocheck "mnemonic" --type evm --checkers

Custom Configuration

Create a config file to customize explorers and add your own checkers:

# Generate sample config
cryptocheck --init-config

Config file locations (checked in order):

./cryptocheck.config.json
./.cryptocheckrc
~/.cryptocheck.json
~/.config/cryptocheck/config.json

Example cryptocheck.config.json:

{
  "apiKeys": {
    "debank": "your-debank-api-key",
    "etherscan": "your-etherscan-api-key",
    "bscscan": "your-bscscan-api-key",
    "polygonscan": "",
    "arbiscan": "",
    "basescan": "",
    "solscan": "",
    "blockchair": ""
  },
  "customExplorers": {
    "ethereum": "https://etherscan.io/address/{address}"
  },
  "additionalCheckers": [
    {
      "name": "My Tracker",
      "urlTemplate": "https://mytracker.com/wallet/{address}",
      "types": ["evm"]
    }
  ],
  "disabledCheckers": []
}

Balance Checking Support

| Chain | Balance API | Notes | |-------|-------------|-------| | EVM chains | RPC | All 10 EVM networks supported | | Solana | RPC | Batch fetching for multiple addresses | | Tron | TronGrid | Native TRX balance | | Bitcoin | Blockchair | BTC balance | | Litecoin | Blockchair | LTC balance | | Dogecoin | Blockchair | DOGE balance | | Cosmos | REST API | ATOM balance | | Aptos | REST API | APT balance | | Sui | JSON-RPC | SUI balance | | Near | JSON-RPC | NEAR balance | | XRP | WebSocket | XRP balance | | Stellar | Horizon API | XLM balance |

API Keys

Configure API keys for enhanced balance checking:

| Service | Get Key | Features | |---------|---------|----------| | DeBank | open.debank.com | Full EVM portfolio with USD values | | Etherscan | etherscan.io/apis | Ethereum balance, higher rate limits | | BSCScan | bscscan.com/apis | BSC balance | | PolygonScan | polygonscan.com/apis | Polygon balance | | Arbiscan | arbiscan.io/apis | Arbitrum balance | | BaseScan | basescan.org/apis | Base balance | | Solscan | pro.solscan.io | Solana balance | | Blockchair | blockchair.com/api | Bitcoin balance |

When API keys are configured, --check uses them automatically:

# With DeBank key: shows total USD portfolio value across all EVM chains
cryptocheck "mnemonic" --check

# Output includes:
# All EVM (DeBank): $1,234.56 USD
# Ethereum: 0.5 ETH
# ...

Error Messages

CryptoChecker provides helpful error messages for invalid inputs:

# Hex key too short
Error: Hex key too short: 32 characters (need 64)

# Hex key too long
Error: Hex key too long: 70 characters (need 64)

# Invalid network for key type
No addresses generated for 'polkadot'.
Polkadot uses sr25519 (Schnorrkel), not secp256k1
polkadot requires: mnemonic only

Use a mnemonic phrase instead:
  cryptocheck "your twelve word mnemonic phrase here" --network polkadot

# Invalid JSON array
Error: Invalid JSON byte array
Must be array of numbers 0-255, with 32 or 64 elements

Project Structure

cryptochecker/
├── cryptocheck.ts          # Main CLI entry point
├── src/
│   ├── index.ts            # Main exports
│   ├── types.ts            # TypeScript type definitions
│   ├── networks.ts         # Network configurations (24 chains)
│   ├── config.ts           # Configuration & checkers
│   ├── balance.ts          # Balance checking (12 chains)
│   ├── chains/
│   │   ├── index.ts        # Chain exports
│   │   ├── evm.ts          # EVM & Tron derivation
│   │   ├── solana.ts       # Solana derivation
│   │   ├── bitcoin.ts      # BTC, LTC, DOGE derivation
│   │   ├── cosmos.ts       # Cosmos derivation
│   │   └── other.ts        # Aptos, Sui, TON, Near, XRP, Stellar, etc.
│   └── utils/
│       ├── index.ts        # Utility exports
│       └── validation.ts   # Input validation helpers
├── tests/
│   ├── chains.test.ts      # Chain derivation tests
│   ├── balance.test.ts     # Balance API tests
│   └── cryptocheck.test.ts # Core functionality tests
├── package.json
└── README.md

Testing

# Run all tests (55 tests across 3 files)
bun test

# Run with verbose output
bun test --verbose

# Run specific test file
bun test tests/chains.test.ts

Security Warning

⚠️ NEVER share your private keys or mnemonic phrases! This tool is for personal use only. Always verify the source code before using it with real keys.

License

MIT

Published

Vulnerabilities

Links

Maintainers

Keywords

Readme

🔐 CryptoChecker

Quick Start

Features

Installation

Option 1: npm (Recommended)

Option 2: npx (No Install)

Option 3: From Source

Troubleshooting

Supported Input Formats

Usage

From Mnemonic (Recommended - All Chains)

From Hex Private Key (EVM, Tron, Bitcoin, Cosmos)

From Bitcoin WIF Key

From Solana Keys

Filtering

Balance Checking

Example Output

From Mnemonic (All 24 Chains)

From Bitcoin WIF Key

From Solana Base58 Key

Compact Output

Derivation Paths

Supported Networks

Bitcoin-like

EVM (Ethereum Compatible)

Other Chains

CLI Options

Custom Checkers & Configuration

Built-in Checkers

Custom Configuration

Balance Checking Support

API Keys

Error Messages

Project Structure

Testing

Security Warning

License