https://github.com/dfinity/hardware-wallet-cli
A CLI to interact with the Internet Computer App on Ledger Nano S/X devices.
https://github.com/dfinity/hardware-wallet-cli
Last synced: 7 months ago
JSON representation
A CLI to interact with the Internet Computer App on Ledger Nano S/X devices.
- Host: GitHub
- URL: https://github.com/dfinity/hardware-wallet-cli
- Owner: dfinity
- License: apache-2.0
- Created: 2022-02-09T11:17:13.000Z (about 4 years ago)
- Default Branch: main
- Last Pushed: 2025-08-25T12:02:59.000Z (8 months ago)
- Last Synced: 2025-09-02T16:56:53.567Z (8 months ago)
- Language: JavaScript
- Homepage:
- Size: 245 KB
- Stars: 12
- Watchers: 27
- Forks: 4
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
# hardware-wallet-cli
A CLI to interact with the Internet Computer App on Ledger Nano S/X devices.
## Important Note
> [!WARNING]
> The CLI does NOT support tokens with different than eight decimals at the moment.
**Do NOT USE the cli to transfer ckETH or ckERC20 tokens.**
## Quick Start
- Install `node >= 18.13.0`.
- Install the CLI: `npm install -g @dfinity/hardware-wallet-cli`
- Run the CLI: `ic-hardware-wallet --help`
## USB connection issues with Ledger Live
In order to install the Internet Computer App on your Ledger device or perform
the genuine check, you need to first connect your Ledger device with the Ledger
Live desktop app running on your computer. If you are facing connection issues
when doing so, Ledger provides platform-specific
[troubleshooting instructions](https://support.ledger.com/hc/en-us/articles/115005165269-Fix-USB-connection-issues-with-Ledger-Live?support=true)
on their support site.
## Development
Clone the repository.
Install dependencies with `npm install`.
To execute a command, you can use `npm run execute -- `.
For example
- The command `ic-hardware-wallet --network https://nnsdapp.dfinity.network icp balance`.
- Would be `npm run execute -- --network http://127.0.0.1:4943 icp balance` for development.