Account Recovery & Delegators Guide
Command Line + Ledger Nano S
This tutorial showcases secure key extraction from the Cosmos Network fundraiser seed and delegation using Ledger Nano S hardware wallet and secure, open source software. If you choose to follow this tutorial make sure you run a clean machine with freshly installed Ubuntu 18.04 LTS operating system or follow or complete our Create Secure Environment Guide. Another (but NOT recommended) option is to run a virtual machine using virtualization software such free VirtualBox and installing Ubuntu as VM to add another security layer but it might not protect you against all kinds of malware that are potentially already hosted on your machine. For this reason you should always verify the address where your transaction is sent on the screen of your hardware wallet and should never trust what your computer screen is showing you.
NOTE: If you choose to not follow Creating Secure Environment Guide and continue with your everyday "use" operating system we can't guarantee safety of your coins and some of the commands might cause breaking changes to your operating system. Remember that Antivirus / Antimalware software will never protect you against all threats and exploits that can reside on your everyday use Laptop or Personal Computer.
- Completing Creation of Secure Environment Guide or clean installation of Ubuntu 18.04 LTS
- Completing Installation of Essential Toolkit on your Secure Environment
Steps To Complete
- Ledger Nano S setup &
COSMOSLedger App installation
- Delegating your coins to validator of choice and querying account balance
- Withdrawing your staking rewards & redelegation
Account Recovery from Cosmos Fundraiser Seed using Ledger Nano S
WARNING!!! (read before you proceed) If you want to recover your fundraiser secret using Ledger Nano S you will have to reset your device. If you already have funds secured by your ledger make absolutely sure that you have access to your current ledger recovery seed NOT just Cosmos Fundraiser Seed. It's recommended that you should use new Ledger Nano S device for the Cosmos Seed Recovery ordered directly from the manufacturer. If you decide to proceed with this method and reset your ledger without having access to your current ledger recovery seed words or not tested that recovery with them works in the past (by for example reinitializing your ledger device before using it) you are in very high risk of permanently losing all your funds currently secured by your ledger device!
In this step you will initialize your Ledger Nano S with your Cosmos Fundraiser Seed Phrases so that your ledger device can be used to delegate your coins and send transactions once transfers are enabled. Note that it's recommended to move your coins to another wallet immediately after ATOM transfers are enabled as security of your seed phrase that was touching web interfaces during fundraiser and likely your every day use laptop can't be guaranteed long term with absolute certainty. Steps presented in this part of the tutorial (Account Recovery From Fundraiser Seed) can be completed on your everyday use PC/Laptop but it is recommended to use a Secure Environment.
- Ledger Nano S with the supplied micro USB cable.
- Computer (at least Windows 8 (64-bit), macOS 10.8, or Linux) with the internet access.
- Connect the Ledger Nano S to your computer using the micro USB/USB cable to power it on.
- If your device was never initialized go to step
3.otherwise to reset your device enter wrong pin 3 times to wipe out it's memory.
- Press both buttons simultaneously as instructed on the device.
- Press the left button located above the cancel icon when asked Configure as new device?
- Press the right button located above the validation icon to select Restore a configuration?
Choose a PIN code
The length of the required PIN code varies:
- Firmware version 1.3 or higher requires a PIN code between 4 and 8 digits long;
- Firmware version 1.2 or lower requires a 4-digit PIN code.
WARNING!!! Always choose your own unique pin code, never enter a pin code supplied or suggested by someone else, e
To set your PIN code:
- Press both buttons when Choose a PIN code is shown on the device.
- Press the right or left button to choose the first digit of your PIN code.
- Press both buttons to select the digit.
- Repeat the process until all digits of your PIN code are selected.
- Select the check icon (✓) and press both buttons to enter the PIN code.
- Enter the PIN code again to confirm.
Enter recovery phrase
Before you proceed make sure that all your cosmos network fundraiser seed words are on the BIP39 word list, that the order of the words is correct and that you did not made any typos. Count the number of seed words which will be required to know for one of the following steps.
- Press the right button to choose the length of your recovery phrase (12, 18 or 24 words). Press both buttons to enter.
- Choose the first letter of Word #1 by pressing the right or left button. Press both buttons to select the letter.
- Select the second letter of Word #1. Repeat until the device shows suggested words to choose from.
- Choose Word #1 from the suggested words. Press both buttons to select it.
- Repeat the process for each word of your cosmos network recovery seed phrase.
- Your device is now ready is displayed if you've successfully entered your recovery phrase.
Cosmos - Ledger App Installation
In case of Ledger each network or blockchain such as Ethereum, Bitcoin, Cosmos has its own dedicated ledger application. In this step we will be installing
COSMOS Ledger App using Ledger Live desktop client. This part of the tutorial requires Ubuntu 18.04, it's highly recommended that for yours and your files security you create a clean Secure Environment. If you choose not follow this advice and use your everyday use operating system you risk permanently corrupting it or losing your data.
- Ledger Nano S with the supplied micro USB cable
- Ubuntu 18.04 LTS Operating System or Completing Creation of Secure Environment Guide.
Ledger Live Installation
Login to your account and enter terminal console by key combination of: CTRL+ALT+T
Install Ledger Live and create a console shortcut by typing or copy pasting following commands into Terminal console and confirming them with ENTER key:
sudo -s apt-get -y update && apt-get -y upgrade mkdir -p $HOME/ledger && cd $HOME/ledger && wget --user-agent="Mozilla/5.0 (X11; Fedora; Linux x86_64; rv:52.0) Gecko/20100101 Firefox/52.0" -O ledger-live https://download-live.ledger.com/releases/latest/download/linux chmod +x $HOME/ledger/ledger-live && ln -s $HOME/ledger/ledger-live /usr/local/bin && ln -s $HOME/ledger/ledger-live /usr/bin
To launch the Ledger Live application all you have to do now is use already open or start a new console terminal with CTRL+ALT+T key combination and then type following command confirmed by ENTER key:
When Ledger Live application starts follow the setup wizard
CLick Get Started
Select Use Initialized Device
Select Ledger Nano S
Go through Checklist
- Before you can select "Check now" option (In the step 3) connect your Ledger Nano S into the PC with the USB cable and enter your pin code.
- Then in the Ledger Live client you click "Check now" button and will have to confirm "Allow Ledger Live manager ?" popup by selecting the check icon (✓) - pressing right button on your Ledger Nano S device.
- To prevent unauthorized access to transactions and account names It is recommended in this step to set a password for the Ledger Live application.
Bug & analytics
Open Ledger Live
Entering Developer Mode
In order to install Cosmos Ledger Application you need to enter a developer mode after accessing your Ledger Live Application.
Click a "Settings" - gear icon in the top right and then scroll to the bottom of the setting list and enable developer mode (switch should turn blue)
Navigate to "Manager" in the MENU on the left then type
Cosmos in the App catalog browser. After few seconds
Cosmos application should pop up, once that happens click an "Install" button.
NOTE: Always install latest version of the Cosmos App (currently 1.5.0), but at the time of reading it might differ, if you do not see the version of the app you were suggested is latest make sure you Updated your ledger first to latest firmware. In case where you see many different 'Cosmos' apps for example
Cosmos pick the one with latest version below it's name. If you already have
COSMOS App installed (for example version 1.3.x) you have to remove it before installing version 1.5.x or later.
After installation is complete you will find new app within your ledger nano device. To enter it you have to click both left and right button at the same time.
It's recommended that you update your Ledger Nano S device to version 1.5.5 or higher otherwise unexpected issues might appear while using gaiacli tool later in the tutorial. Update option/button can be found in the top right corner of the Manager view in the Ledger Live client.
Delegators Guide using Ubuntu 18.04 LTS
Once installation of essential tools and Cosmos Ledger Application is completed you can proceed to create new "account" using
gaiacli that will later be used to delegate your coins. For the tutorial purposes we will call your new account
FundraiserAccountLedger but it can be any word that will help you recognize it origin.
Before you proceed make sure your Ledger Nano S device is connected to your PC with the supplied USB cable and that you entered
Cosmos Ledger Application otherwise following command will fail with the "ERROR: ledger nano S: are you sure the Cosmos app is open?"
Enter terminal console by key combination of: CTRL+ALT+T
Create your cosmos account, by typing or copy pasting following commands into Terminal console and confirming them with ENTER key:
sudo -s gaiacli keys add FundraiserAccountLedger --ledger
Result of the command should output
PUBKEY separated by whitespaces.
ADDRESS aka Cosmos Account Number is a public string with a human-readable prefix (e.g. cosmos1xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx) that identifies your account. When someone wants to send you funds you can provide them with that address.
Connecting to Cosmos Seed Node
gaiacli config trust-node false gaiacli config chain-id cosmoshub-2 gaiacli config node https://nodes.cosmos-validators.com:443
To check current block height run:
gaiacli status | jq -r '.sync_info.latest_block_height'
To query your account balance execute:
gaiacli query account cosmos1xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
NOTE: Your balance is displayed in
uatom "Mico Atoms" NOT ATOMs so be careful. During delegation the amount will also have to be defined in uatoms.
1 ATOM ==
1'000'000 uatom's so you have to remember to add 6 more zeroes to the value you want to delegate.
If you typed something wrong and you see error saying configuration is invalid or that there are issues with "toml" file, you can edit it by typing:
Content should resemble following screenshot
NOTE: When using nano editor in order to save changes press combination of keys: CTRL+O, [ENTER], CTRL+X
Delegating ATOMs to Your Validator of choice
For the purpose of this tutorial we will use Bity.com Cosmos Validator public address that is
NOTE: This tutorial will work regardless of the validator public address you choose, please ensure good practices and due diligence when selecting validators to delegate your coins.
Before you can delegate you have to specify
<amountToBond>. this amount is "the amount you want to delegate" defined in micro atoms (
10^-6 atoms or
1'000'000 uatoms per
If you wish to for example delegate
123 ATOMS you have to set this amount to
123000000uatom (suffix with
6 zeros and 'uatom' sting without white spaces)
Before you enter following command make sure that your Ledger Nano S device is connected to your PC and that you navigate to and enter
COSMOS App before executing it.
gaiacli tx staking delegate cosmosvaloper1uv26ytrnmydyctq0s58ve2k6wn2p653mqs80fm <amountToBond>uatom --from FundraiserAccountLedger --fees=50000uatom --chain-id cosmoshub-2
After executing the command you have to confirm it with Y key followed by [ENTER] and then verify correctness on your Ledger Nano S screen, continue the tx preview by clicking right button unit
Sign transaction option appears then click both left and right button at the same time.
From time to time you might experience
Response: ERROR: broadcast_tx_commit: Response error: RPC error -32603 - Internal error: Timed out waiting for tx to be included in a block in such case you can just repeat the command until it succeeds.
Collecting Delegation Rewards
After certain period of time your account will accumulate rewards proportional to your stake and inflation of ATOM coins, in order to have your coins credited to your account you will have to send a "withdraw" transaction.
NOTE: If coins you earn are not withdrawn and then re-delegated they will not be earning you rewards so it's a good practice to once every while withdraw the rewards and redelegate for them to earn you more interest.
gaiacli tx distr withdraw-all-rewards --from FundraiserAccountLedger --fees=50000uatom
Wait few seconds after confirming your transaction and retyping account password, then you can use following command to verify change on your account balance:
gaiacli query account cosmos1xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx