certusone
/
cosmos-sdk
mirror of https://github.com/certusone/cosmos-sdk.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
cosmos-sdk/docs/migrations/keyring.md

1.7 KiB
Raw Blame History

Keyring Migrate Quick Start

keyring is the Cosmos SDK mechanism to manage the public/private keypair. Cosmos SDK v0.42 (Stargate) introduced breaking changes in the keyring.

To upgrade your chain from v0.39 (Launchpad) and earlier to Stargate, you must migrate your keys inside the keyring to the latest version. For details on configuring and using the keyring, see Setting up the keyring.

This guide describes how to migrate your keyrings.

The following command migrates your keyrings:

Usage
simd keys migrate <old_home_dir>

The migration process moves key information from the legacy db-based Keybase to the keyring-based Keyring. The legacy Keybase persists keys in a LevelDB database in a 'keys' sub-directory of the client application home directory (old_home_dir). For example, $HOME/.gaiacli/keys/ for Gaia.

You can migrate or skip the migration for each key entry found in the specified old_home_dir directory. Each key migration requires a valid passphrase. If an invalid passphrase is entered, the command exits. Run the command again to restart the keyring migration.

The migrate command takes the following flags:

  • --dry-run boolean

    • true - run the migration but do not persist changes to the new Keybase.
    • false - run the migration and persist keys to the new Keybase.

Recommended: Use --dry-run true to test the migration without persisting changes before you migrate and persist keys.

  • --keyring-backend string flag. It allows you to select a backend. For more detailed information about the available backends, you can read the keyring guide.