CLI - Managing Keys¶
Managing your keys is an essential part of working with the Ledger, since all interactions are authenticated with these keys.
Adding keys¶
To create a new local key you need run the following command:
Note
These keys are stored locally on your system. By default, these keys will be stored in the OS level keychain, however, in general these keys are considered less secure than using a hardware device
After running the command fetchd will print out a summary of the new key. An example of this output is shown below:
- name: test
type: local
address: fetch142tawq2rj397mctc3jtw9dfzf03ns0ze4swat0
pubkey: fetchpub1addwnpepqvtmze0ekffynnjx9n85g6sexzl49ze2vpgc2f52fteyyghjtvvqw682nkx
mnemonic: ""
threshold: 0
pubkeys: []
This will be followed by a 24-word mnemonic that can be used to re-generate the private key and address for the account (keep this safe, if ever used to control main-net tokens).
Looking up an address¶
A common operation that you will want to do is to lookup the address for a specified key. This can be done quickly using the following command:
An example of the expected output is shown below:
A less common operation, but still useful, would be to lookup the public key for a specified key. The can be achieved with the following command:
An example of the expected output is shown below:
Listing keys¶
To lookup more detailed information for all keys on your system use the following command:
This will output all of your keys information in a yaml format that is similar to the one generated when you first created the key.
- name: test
type: local
address: fetch142tawq2rj397mctc3jtw9dfzf03ns0ze4swat0
pubkey: fetchpub1addwnpepqvtmze0ekffynnjx9n85g6sexzl49ze2vpgc2f52fteyyghjtvvqw682nkx
mnemonic: ""
threshold: 0
pubkeys: []
Recovering a key¶
You can import a key from a 24-word mnemonic by running:
You'll be prompted to enter the mnemonic phrase, and it will then print the matching address and key details as when creating a new key.Hardware Wallets¶
Setup¶
We recommend hardware wallets as a solution for managing private keys. The Fetch ledger is compatible with Ledger Nano hardware wallets. To use your Ledger Nano you will need to complete the following steps:
- Set-up your wallet by creating a PIN and passphrase, which must be stored securely to enable recovery if the device is lost or damaged.
- Connect your device to your PC and update the firmware to the latest version using the Ledger Live application.
- Install the Cosmos application using the software manager (Manager > Cosmos > Install).
Adding a new key¶
In order to use the hardware wallet address with the cli, the user must first add it via fetchd. This process only records the public information about the key.
To import the key first plug in the device and enter the device pin. Once you have unlocked the device navigate to the Cosmos app on the device and open it.
To add the key use the following command:
Note
The --ledger flag tells the command line tool to talk to the ledger device and the --index flag selects which HD index should be used.
When running this command, the Ledger device will prompt you to verify the generated address. Once you have done this you will get an output in the following form: