CLI for managing Cryptnox Hardware Wallet smart cards
cryptnox-cli is a command-line interface for managing Cryptnox Hardware Wallet smart cards, enabling secure seed initialization and cryptographic signing for Bitcoin and Ethereum.
Works with Cryptnox Hardware Wallet smart cards running firmware v1.6.0 or later.
| Smart card | Wallet version |
|---|---|
| Crypto Hardware Wallet – Dual Card Set | v1.6.1 |
Works with Cryptnox readers and any other standard PC/SC smart card reader:
| Reader | Type | Interface |
|---|---|---|
| Cryptnox® Smartcard Reader | Contact (ID-1 + SIM) | USB-A |
| Compact USB Mini Smartcard Reader | Contact (ID-1) | USB-A |
| Cryptnox NFC Contactless Reader | Contactless (NFC/ISO 14443) | USB-C |
Important
This is only a minimal setup. Additional packages may be required depending on your operating system. See Installation and requirements.
pip install cryptnox-climstore install cryptnox-cliVisit the MStore page to install cryptnox-cli via the graphical user interface.
git clone https://github.com/cryptnox/cryptnox-cli.git
cd cryptnox-cli
pip install .This installs the package and makes the cryptnox command available (if your Python installation is in your system PATH).
Tip
The examples below are only a subset of available commands. The complete list of commands and detailed usage instructions is described in the official documentation.
- Create or obtain a raw unsigned transaction externally.
- Run the signing & send command:
cryptnox btc send <recipient_address> <amount> [-f <fees>]
-
Factory reset each card:
cryptnox reset→ enter PUK → verify reset. -
Initialize each card:
cryptnox init→ (optional) set name/email → set PIN (4–9 digits) → set or generate PUK → verify init. -
Run dual seed procedure:
cryptnox seed dual— follow prompts: insert Card A (enter PIN), swap to Card B (enter PIN), swap back as requested.
- Run command:
cryptnox change_pin - Enter current PIN → enter new PIN → verify change.
- Check with
cryptnox infousing new PIN (BTC & ETH accounts displayed).
- Run command:
cryptnox get_xpub - Enter PIN → enter PUK
- The card returns the xpub
The full User & Developer documentation is available at the Cryptnox CLI Documentation. It covers installation and setup, usage guides and examples, CLI command reference, and developer notes with API details.
cryptnox-cli is dual-licensed:
- LGPL-3.0 for open-source projects and proprietary projects that comply with LGPL requirements
- Commercial license for projects that require a proprietary license without LGPL obligations (see COMMERCIAL.md for details)
For commercial inquiries, contact: [email protected]

