Renaming Keys

Command

Sometimes you find yourself needing to rename one or more keys stored inside one of your keystores. Existing keys managed by sagacli can also be renamed.

To rename a key, type

sagacli keys rename <oldkeyname> <newkeyname>

For example, to rename a key called metamask to fundkey, you would type:

$ sagacli keys rename metamask fundkey
Key reference will be renamed from metamask to fundkey. Continue? [y/N]: y
Key was successfully renamed from metamask to fundkey

Confirming Success

To confirm that the key was successfully renamed, you can list all of the keys managed by sagacli

$ sagacli keys list
- address: saga14hyhswxf0shnpzup406yvjejmfsrjnvzq897re
  name: fundkey
  pubkey: '{"@type":"/cosmos.crypto.secp256k1.PubKey","key":"A4lAzjJ4bZnZIEhYQvW+qsgg9SzwQOkOgFG+q5enEv4l"}'
  type: local
- address: saga1tkax73wxs047nc8kaalhfc4ar6gay2sde28crx
  name: mykey1
  pubkey: '{"@type":"/cosmos.crypto.secp256k1.PubKey","key":"A1YCpZPIzs6MXTiMAOnlEK6Cq8+JQMii9a4vUnyQ0qGs"}'
  type: local
- address: saga1z0uscdcprxcun2mlnyrz5kelemmjw768sdrgz5
  name: test1
  pubkey: '{"@type":"/cosmos.crypto.secp256k1.PubKey","key":"A+u4iLJZWZHHcRIEbme8ppbmk1jYTpZVio8anPqAIQ31"}'
  type: local

You can see that we no longer have a key named metamask as it has been renamed to fundkey.

Further Details

To get a full list of options supported by the rename command, type

sagacli keys rename --help