Official Ledger wallet-cli — USB-based CLI for Ledger hardware wallet flows (account discover, receive, balances, operations, send) built on the Device Management Kit (DMK)
wallet-cli is an experimental USB-based CLI for Ledger wallet flows, built on the Device Management Kit (DMK). Supported networks: bitcoin, ethereum, base, solana (mainnet and testnets). On Ledger devices, Base uses the Ethereum app.
Device contention: Only one command can use the device at a time. Never run two device-required commands in parallel — they will conflict and fail with
[object Object]or a garbled APDU error. Run device commands sequentially.
Prerequisites: Ledger device connected via USB, with the relevant coin app open on device for commands that require it (Base requires opening the Ethereum app).
Run from repo root:
pnpm --silent wallet-cli start <command> [flags]
Sandbox: Commands that open the USB device (
account discover,receive,send) must be run withdangerouslyDisableSandbox: truein the Bash tool — the sandbox blocks USB access and causes aTimeout has occurrederror. Commands that don't need the device (balances,operations,send --dry-run) work fine in the sandbox.
| Command | Device required | Disable sandbox |
|---|---|---|
account discover | Yes | Yes |
receive | Yes (optional with --no-verify) | Yes |
send | Yes (unless --dry-run) | Yes (unless --dry-run) |
balances | No | No |
operations | No | No |
account discover outputs V1 descriptors: