Command Line Usage
HWI is primarily used from the command line.
Users can use the hwi
command directly, or the HWI self-contained binaries can be distributed with third party software and executed by the software.
The usage of hwi
can be found with hwi --help
.
hwi
Hardware Wallet Interface, version 2.4.0. Access and send commands to a hardware wallet device. Responses are in JSON format.
usage: hwi [-h] [--device-path DEVICE_PATH] [--device-type DEVICE_TYPE]
[--password PASSWORD] [--stdinpass]
[--chain {main,test,regtest,signet}] [--debug]
[--fingerprint FINGERPRINT] [--version] [--stdin] [--interactive]
[--expert]
{enumerate,getmasterxpub,signtx,getxpub,signmessage,getkeypool,getdescriptors,displayaddress,setup,wipe,restore,backup,promptpin,togglepassphrase,sendpin,installudevrules}
...
options
- -h, --help
show this help message and exit
- --device-path <device_path>, -d <device_path>
Specify the device path of the device to connect to
- --device-type <device_type>, -t <device_type>
Specify the type of device that will be connected. If –device-path not given, the first device of this type enumerated is used.
- --password <password>, -p <password>
Device password if it has one (e.g. DigitalBitbox)
- --stdinpass
Enter the device password on the command line
- --chain {main,test,regtest,signet}
Select chain to work with
- --debug
Print debug statements
- --fingerprint <fingerprint>, -f <fingerprint>
Specify the device to connect to using the first 4 bytes of the hash160 of the master public key. It will connect to the first device that matches this fingerprint.
- --version
show program’s version number and exit
- --stdin
Enter commands and arguments via stdin
- --interactive, -i
Use some commands interactively. Currently required for all device configuration commands
- --expert
Do advanced things and get more detailed information returned from some commands. Use at your own risk.
hwi backup
usage: hwi backup [-h] [--label LABEL] [--backup_passphrase BACKUP_PASSPHRASE]
- -h, --help
show this help message and exit
- --label <label>, -l <label>
The name to give to the device
- --backup_passphrase <backup_passphrase>, -b <backup_passphrase>
The passphrase to use for the backup, if applicable
hwi displayaddress
usage: hwi displayaddress [-h] (--desc DESC | --path PATH)
[--addr-type {legacy,wit,sh_wit,tap}]
- -h, --help
show this help message and exit
- --desc <desc>
Output Descriptor. E.g. wpkh([00000000/84h/0h/0h]xpub…/0/0), where 00000000 must match –fingerprint and xpub can be obtained with getxpub. See doc/descriptors.md in Bitcoin Core
- --path <path>
The BIP 32 derivation path of the key embedded in the address, default follows BIP43 convention, e.g.
m/84h/0h/0h/1/*
- --addr-type {legacy,wit,sh_wit,tap}
The address type to display
hwi enumerate
usage: hwi enumerate [-h]
- -h, --help
show this help message and exit
hwi getdescriptors
usage: hwi getdescriptors [-h] [--account ACCOUNT]
- -h, --help
show this help message and exit
- --account <account>
BIP43 account
hwi getkeypool
usage: hwi getkeypool [-h] [--keypool | --nokeypool] [--internal]
[--addr-type {legacy,wit,sh_wit,tap} | --all]
[--account ACCOUNT] [--path PATH]
start end
- start
The index to start at.
- end
The index to end at.
- -h, --help
show this help message and exit
- --keypool
Indicates that the keys are to be imported to the keypool
- --nokeypool
Indicates that the keys are not to be imported to the keypool
- --internal
Indicates that the keys are change keys
- --addr-type {legacy,wit,sh_wit,tap}
The address type (and default derivation path) to produce descriptors for
- --all
Generate addresses for all standard address types (default paths:
m/{44,49,84}h/0h/0h/[0,1]/*)
- --account <account>
BIP43 account
- --path <path>
Derivation path, default follows BIP43 convention, e.g.
m/84h/0h/0h/1/*
with –addr-type wpkh –internal. If this argument and –internal is not given, both internal and external keypools will be returned.
hwi getmasterxpub
usage: hwi getmasterxpub [-h] [--addr-type {legacy,wit,sh_wit,tap}]
[--account ACCOUNT]
- -h, --help
show this help message and exit
- --addr-type {legacy,wit,sh_wit,tap}
Get the master xpub used to derive addresses for this address type
- --account <account>
The account number
hwi getxpub
usage: hwi getxpub [-h] path
- path
The BIP 32 derivation path to derive the key at
- -h, --help
show this help message and exit
hwi installudevrules
usage: hwi installudevrules [-h] [--location LOCATION]
- -h, --help
show this help message and exit
- --location <location>
The path where the udev rules files will be copied
hwi promptpin
usage: hwi promptpin [-h]
- -h, --help
show this help message and exit
hwi restore
usage: hwi restore [-h] [--word_count WORD_COUNT] [--label LABEL]
- -h, --help
show this help message and exit
- --word_count <word_count>, -w <word_count>
Word count of your BIP39 recovery phrase (options: 12/18/24)
- --label <label>, -l <label>
The name to give to the device
hwi sendpin
usage: hwi sendpin [-h] pin
- pin
The numeric positions of the PIN
- -h, --help
show this help message and exit
hwi setup
usage: hwi setup [-h] [--label LABEL] [--backup_passphrase BACKUP_PASSPHRASE]
- -h, --help
show this help message and exit
- --label <label>, -l <label>
The name to give to the device
- --backup_passphrase <backup_passphrase>, -b <backup_passphrase>
The passphrase to use for the backup, if applicable
hwi signmessage
usage: hwi signmessage [-h] message path
- message
The message to sign
- path
The BIP 32 derivation path of the key to sign the message with
- -h, --help
show this help message and exit
hwi signtx
usage: hwi signtx [-h] psbt
- psbt
The Partially Signed Bitcoin Transaction to sign
- -h, --help
show this help message and exit
hwi togglepassphrase
usage: hwi togglepassphrase [-h]
- -h, --help
show this help message and exit
hwi wipe
usage: hwi wipe [-h]
- -h, --help
show this help message and exit