✨ Features

• 🔍 Validate single BIP-39 words
• 🔠 Validate entire mnemonics
• 🌍 Supports 8 official BIP-39 languages
• 🔧 CLI included: bip39check
• 🧠 Smart spelling suggestions
• ⚡ Zero external dependencies besides bip39
• 📘 Full TypeScript definitions
• 🏁 Short language flags (--en, --es, --jp)
• 🔥 Tiny, fast, production-ready

🌍 Supported Languages

🚀 Installation

Global CLI:

🧠 API Usage

🧩 Validate Mnemonics

English Example

Japanese Example

🛠️ CLI Usage

After global install:

🌍 Language Flags (Short & Full)

English:

Spanish:

Japanese:

Chinese Simplified:

🧩 Validate Full Mnemonic

📘 Help

🧪 Run Tests

🔐 Security

This library is designed with security in mind:

• ✅ No logging of mnemonics or words
• ✅ No network calls – everything runs locally
• ✅ Uses the official bip39 wordlists & checksum logic
• ✅ Validates both word membership and BIP-39 checksum
• ✅ Works in Node.js and can be bundled for browser/extension use

Important: this package does not generate keys, addresses, or wallets.
It only validates BIP-39 phrases; you remain in full control of how you handle secrets.

🆚 Why use this instead of bip39 directly?

bip39 is a great low-level library, but bip39-validator gives you a focused, higher-level API:

🧪 Playground

A small interactive playground:

https://bip39-validator-app.vercel.app/ (live)

You’ll be able to:

• Paste a mnemonic
• See if it’s valid
• See why it fails (checksum, length, unknown words)
• Get suggestions for mistyped words

🛠 Migration Guide: v1.x → v2.0 → 3.0

🤝 Contributing

Pull requests welcome!

https://github.com/ARichie1/bip39-validator