Cryptocurrency mnemonic phrase identifier and address derivation analysis tool.
- Unified Derivation Engine (
bip-utils):- Replaced custom Electrum submodule,
hdwallet, andblockcypherwithbip-utils. - The bundled
electrum/repository is completely removed.
- Replaced custom Electrum submodule,
- Account-Level Derivations (EVM, Solana, Tron):
- Ethereum / EVM: Derives the first accounts (
m/44'/60'/account'/0/0) rather than address indexes on account 0. - Solana: Derives the first accounts (
m/44'/501'/account'/0'). - Tron: Derives the first accounts (
m/44'/195'/account'/0/0).
- Ethereum / EVM: Derives the first accounts (
- Privacy Disclaimer & Confirmation:
- Warns before querying public Electrum servers and RPC endpoints.
- User must confirm (
[y/N]) before online requests are sent; declining falls back to offline derivation automatically. - Use
-y/--yesto auto-accept in non-interactive scripts.
- Online Checks via Public Stratum & RPCs:
- BTC / LTC / DASH: Direct connection to public Electrum Stratum servers over SSL (port 50002) via scripthash queries (
blockchain.scripthash.get_balance,blockchain.scripthash.get_history). - EVM (Ethereum): Direct queries to public EVM JSON-RPC endpoints (
eth_getBalance,eth_getTransactionCount). - Solana: Direct queries to public Solana JSON-RPC endpoints (
getBalance,getSignaturesForAddress). - Tron: Direct queries to public TronGrid API (
/v1/accounts/{address}). - No API keys or third-party rate limits required.
- BTC / LTC / DASH: Direct connection to public Electrum Stratum servers over SSL (port 50002) via scripthash queries (
- Offline Mode:
- Run
--offlineto perform purely local derivation and seed identification without contacting any network servers.
- Run
pip install -r requirements.txtpython seedcheck.py# Check a seed phrase (prompts for online confirmation)
python seedcheck.py -s "abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon about"
# Auto-confirm online checks
python seedcheck.py -s "your mnemonic here" -y
# Derive 5 accounts/addresses instead of the default 3
python seedcheck.py -s "your mnemonic here" -c 5 -y
# Offline derivation only (no disclaimer, no network requests)
python seedcheck.py -s "your mnemonic here" --offline
# With a passphrase
python seedcheck.py -s "your mnemonic here" -p "mySecretPassphrase"