Get started with Keplr Browser Extension

Published in

Chainapsis

12 min readNov 17, 2020

*In this tutorial we’ll use $ATOM as example, but the process is applicable for all integrated tokens as

⭐️ Cosmos ($ATOM)
⭐️ Kava ($KAVA)
⭐️ Secret Network ($SCRT — $sSCRT)
⭐️ Cyber Euler-6 ($EUL)
⭐️ Straightedge ($STR)
⭐️ Akash Network ($AKT)
⭐️ Starname ($IOV)
⭐️ Certik ($CTK)
⭐️ Sifchain ($ROWAN)
⭐️ IRISnet ($IRIS)
⭐️ Sentinel ($DVPN)
⭐️ Regen Network ($REGEN)
⭐️ Crypto.com ($CRO)
⭐️ Osmosis ($OSMO)
⭐️ Persistence ($XPRT)
⭐️ IXO ($IXO)

We will also learn how to add mainnets available via [Suggest Chain] feature such as Oraichain, BitSong, LikeCoin, and e-Money.

⚠️ Keplr extension is officially supported only on Chrome.
It can also be used on Brave, but some features may be unavailable.
It isn’t possible to use Keplr extension from mobile.

⚠️ Pay attention to the websites you connect your Keplr wallet to and only download Keplr from the official website or from the link you can find in this tutorial. The same principle applies to any other wallet.

⚠️ No one from Cosmos and Keplr team will ever write you in a DM asking to validate your wallet or type your mnemonics:
Please be careful of scammers and if you need help always use public channels.
You are your own bank: help us in assisting you in keeping it safe.

Go to this link and click the [Add] button
[Add “Keplr”] window will show off.
Here you have to choose [Add Extension]
At the end of the download, you can start to interact with your browser extension by clicking on it.
Now you have 4 options: import your account from a compatible* non-custodial wallet, import your Ledger account, create a new account via seed/mnemonic phrase or via [One-Click Login].
*[compatible] means a wallet that allows you to use the mnemonic/seed phrase to import your account to Keplr.

If you are setting up Keplr for the first time:
In the initial pop-up window, choose [Import Existing Account]
If you have used Keplr before:
In the extension click on the silhouette in the upper-right corner, then the blue box [Add Account] & select [Import Existing Account]
Enter your mnemonic/seed phrase in the appropriate slot, separating the words by space & taking care to check that they are spelled correctly.
Make sure you have imported the account with the correct derivation path, viewable by clicking on [Advanced].
Normally, the derivation path should be m/44'/…’/0/0/0, but if you see that importing the account via mnemonic on Keplr the cosmos mainnet address displayed is different from yours, it is possible that the derivation path ends with 1 (or another number) instead of 0.
If this is the case, all you have to do is start the process over and replace the last 0 with 1.
If you are interested in knowing more about the HD wallet derivation path, you can find more in the Keplr FAQ, section [General Questions].
If you have just downloaded Keplr extension, it’s time to set your password! Choose carefully, if possible prefer a password you’re not using in any other application, and then click [Confirm].
If you have used Keplr before, this step will be skipped as you have already set your password when creating/importing your first account.
Select [Done].

If you are setting up Keplr for the first time:
In the initial pop-up window, choose [Import Ledger]
If you have used Keplr before:
In the extension click on the silhouette in the upper-right corner, then the blue box [Add Account] & select [Import Ledger]
To complete the connection with your Ledger Nano Hard Wallet, follow the steps described in the pop-up that will appear (you can find a detailed tutorial here).
Make sure you have imported the account with the correct derivation path.
If you are interested in knowing more about the HD wallet derivation path, you can find more in the Keplr FAQ, section [General Questions].
If you have just downloaded Keplr extension, it’s time to set your password! Choose carefully, if possible prefer a password you’re not using in any other application, and then click [Confirm].
If you have used Keplr before, this step will be skipped as you have already set your password when creating/importing your first account.
Select [Done].

👤 How to create a new Account via Manemonic/Seed Phrase

If you are setting up Keplr for the first time:
In the initial pop-up window, choose [Create New Account]
If you have used Keplr before:
In the extension click on the silhouette in the upper-right corner, then the blue box [Add Account] & select [Create New Account]
Choose to have a seed/mnemonic phrase of 24 words, then take care to save them.
The safest way is to write the words on paper and store them in a secure place. Avoid taking screenshots of the words or copying them into your computer/phone notes.
Now enter a name for your account (you can change it later).
You can change the derivation path by clicking on [Advanced], but this is optional and not suggested for how we are going to use Keplr.
If you are interested in knowing more about the HD wallet derivation path, you can find more in the Keplr FAQ, section [General Questions].
Once you are sure that you have correctly transcribed the seed/mnemonic phrase, click on [Next].
To confirm the creation of the new account, all you have to do is click on the words in the right order in which they appear in your seed/mnemonic phrase and press [Register].
If you have just downloaded Keplr extension, it’s time to set your password! Choose carefully, if possible prefer a password you’re not using in any other application, and then click [Confirm].
If you have used Keplr before, this step will be skipped as you have already set your password when creating/importing your first account

👤 How to create a new Account via One-Click Login

Note: The suggested path is to create an account via Mnemonic phrase or delegate via Ledger, I’m illustrating this procedure only because is the first time it is applied to Cosmos wallets and people might be not familiar with it.

Choose the option [Sign in with Google]
Now enter the email|phone number associated with your Google account, its password, and then click [Next].
In case you don’t have an account yet, you can create one by pressing the [create account] button.
Time to set your Keplr Wallet password! Choose carefully, if possible one password you’re not using in any other application, and then click [Confirm]

The tokens listed above are natively supported in Keplr extension, so no additional action is required from your side.

To be able to visualize your mainnet addresses, manage your tokens, and switch between networks you have two options:

Click on the network name at the top of the extension and select from the drop-down menu the network you wish to view.
Open the Dashboard and click on the network you wish to view from the menu on the left.

💡 Experiencing disruptions? Check the FAQ

• $BTSG (BitSong)
• $NGM (e-Money)
• $LIKE (LikeCoin)
• $ORAI (Oraichain)
The tokens listed above are not natively supported in Keplr but can be added manually or linked to your extension.

💱 e-Money

Go to wallet.e-money.com
[Chain Add Request] window will show off.
Here you have to choose [Approve]
Now you have to authorize the connection between Keplr and e-Money:
In the [Requesting Connection] window, select [Approve] to continue.
Check now your Wallet by clicking on the [K] extension icon:
Among the networks you can select, you may notice that in the [Beta Support] section [e-Money Wallet] is now available.
You will now be able to visualize your mainnet address & manage your $NGM via the dedicated Dashboard.

🎶 BitSong

Go to play.bitsong.io and click [Connect Wallet] on the top-right.
Scroll all down and select [Import Your Wallet] and click on the Keplr logo.
[Chain Add Request] window will show off.
Here you have to choose [Approve]
Now you have to authorize the connection between Keplr and BitSong:
In the [Requesting Connection] window, select [Approve] to continue.
Check now your Wallet by clicking on the [K] extension icon:
Among the networks you can select, you may notice that in the [Beta Support] section [BitSong] is now available.
You will now be able to visualize your mainnet address & manage your $BTSG via the dedicated Dashboard.

👏🏻 LikeCoin

Go to like.co/in and click [Sign in with your Wallet] on the top-right of the pop-up window.
In the [Sign in with your wallet] window, click on [Accept]
Now choose the option [Sign in with Keplr]
[Chain Add Request] window will show off.
Here you have to choose [Approve]
Now you have to authorize the connection between Keplr and Likecoin:
In the [Requesting Connection] window, select [Approve] to continue.
You will now have to confirm your access through an on-chain transaction: select [low] fee to execute the operation without using any $LIKE
You will now see the [Welcome] screen, where you will be prompted to create a Liker ID and enter your email. You can optionally upload a photo as your avatar.
Check your email to confirm the address you provided and complete your registration!
Check now your Wallet by clicking on the [K] extension icon:
Among the networks you can select, you may notice that in the [Beta Support] section [LikeCoin Chain] is now available.

💫 Oraichain

Bridge:

Go to bridge.orai.io and click on the Keplr logo.
[Chain Add Request] window will show off.
Here you have to choose [Approve]
Now you have to authorize the connection between Keplr and BitSong:
In the [Requesting Connection] window, select [Approve] to continue.
Check now your Wallet by clicking on the [K] extension icon:
Among the networks you can select, you may notice that in the [Beta Support] section [Oraichain] is now available.
You will now be able to visualize your mainnet address & manage your $ORAI via the dedicated Dashboard.

Mainnet

Go to airight.io and click on [Connect Wallet].
Select [Connect ORAI/Keplr wallet], then [Connect Keplr Wallet]
[Chain Add Request] window will show off.
Here you have to choose [Approve]
Now you have to authorize the connection between Keplr and Oraichain sending a transaction:
In the window, select [Approve] to continue.
You will now be able to visualize your mainnet address & manage your $ORAI via the dedicated Dashboard.

💡 Experiencing disruptions? Check the FAQ

📥 How to deposit your Tokens

Click on the Keplr Icon on the top-right side of your window to open it.
Select [Deposit] and the wallet will show you your address and the associated QR code.
Once you’ve sent your ATOMs to your Keplr wallet, you will visualize the available balance.

📤 How to send your Tokens

Now let’s try the [Send] option.
Once you have selected the right button, you will visualize multiple fields:
• Recipient: the address you want to send your ATOMs.
ENS (ethereum name service) will be soon integrated as well.
To notice the possibility to save a cosmos address in a very easy-to-use agenda, as you can see in the pictures below.
• Amount: the number of ATOMs you want to send with this transaction
• Balance: this displays the funds at your disposition
• Memo (Optional): as you know, transaction to/from exchanges most of the time requires a specific memo. Please check carefully if this is your case. If not, you can leave it white.
• Fee: you can choose between [Low], [Average] and [High].
Only a few validators admit low fee transactions, so that might translate to a longer waiting time to have the process done.
When all fields are accurately entered, it’s time to select [Send].
A summary screen will now appear.
If all the information are correct, click [Approve] to complete the operation.
You can easily check the status of your transaction via explorer.
The transaction was successfully sent, Yay!

🔒 How to stake your [Natively Supported] Tokens

Select [Stake] on Keplr, you will be redirected to the web version of the wallet.
All validators belonging to the active set will be displayed here. You can see the details of each of them, the ATOMs already at stake, and the expected commissions.
To help Cosmos on its path towards decentralization it is recommended to delegate to validators who are outside the first 10 positions.
Once you have chosen your validator, select [Stake].
In this new window, you will be asked to select the number of ATOMs you want to delegate to that validator. Once you have entered this field, press [Stake] again to continue.
The next screen is about the choice of the desired commission for the payment of the transaction on-chain. It is the same as before.
Recap: If the details displayed match your requests, click [Approve] to complete the operation.
Operation Successful!
Good Job Cosmonaut,
Cosmos is a safer place thanks to your delegation!

🔓 Claim your Rewards & Redelegate

Don’t forget to [Claim] your rewards from time to time and to use the new [Undelegate] & [Redelegate] features to manage your $ATOM with the maximum flexibility!
1. Click on [Claim] to reclaim all your pending staking rewards.
2. Click on [Re-Delegate] to change your validator. You can do this immediately the first time, then you must wait 21 days before re-delegate again.
3. Choose [Undelegate] to remove your ATOM from staking. During the *21 days of unbounding you will not be able to manage your tokens or gain staking rewards. Once you start the unbounding you can’t interrupt it.
*Unbounding period might vary from chain to chain

Please note that to successfully complete the operations mentioned above, you must have in your [Available Balance] enough ATOM to cover the transaction fee, so pay attention to always keep a minimum of funds not staked (0.1 ATOM is enough).
Keep in mind that if you re-delegate to another validator, delegate more ATOM to the same validator or start the unbounding, all your pending rewards will be automatically claimed & added to your available balance.

🌱 Do you want to export your Seed Phrase?

In the extension click on the silhouette in the upper-right corner.
Click on the three dots and in the drop-down menu select [View Mnemonic Seed].
Confirm the operation by writing your Password.
Copy the Mnemonic Seed Phrase and store it in a safe place.
Remember that taking a screenshot as well as storing the words in an unsecured, internet-connected device is extremely dangerous.

🧸 Do you want to add or Create a New Account to Keplr?

In the extension click on the silhouette in the upper-right corner.
Click in the blue box [Add Account]
Select the preferred option between [Create New Account] [Import Existing Account] and [Import Ledger].