How to use Keplr Wallet

How to use Keplr Wallet

This blog post was originally published on Keplr's Medium blog on July 28, 2020.

Introduction & tutorial of the Wallet that puts the user experience at the heart of its design.

Summary

  • Get started with Keplr Browser Extension
  • Getting Started with Osmosis
  • Getting Started with IBC Transfers
  • How to vote for Governance Proposals with Keplr Wallet
  • Enable & Mint $sSCRT with Keplr
  • How to add e-Money support to Keplr
  • How to reserve a *Starname with Keplr and link it to your personal crypto addresses

Get started with Keplr Browser Extension

In this tutorial we use $ATOM as example, but the process is applicable for all integrated tokens including Cosmos ($ATOM), Kava ($KAVA), Secret Network ($SCRT), Akash Network ($AKT), Starname ($IOV), Certik ($CTK), Sifchain ($ROWAN), IRISnet ($IRIS), Sentinel ($DVPN), Regen Network ($REGEN), Crypto.com ($CRO), Osmosis ($OSMO), Persistence ($XPRT), and IXO ($IXO).

⚠️ 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 with and only download Keplr from the official website.

⚠️ 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.

How to Import an Existing Account

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] and select [Import Existing Account]. Enter your mnemonic/seed phrase in the appropriate slot, separating the words by spaces. Make sure you have imported the account with the correct derivation path, viewable by clicking on [Advanced].

How to Import a Ledger Account

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: click on the silhouette in the upper-right corner, then [Add Account] and select [Import Ledger]. Follow the steps in the pop-up to complete the connection with your Ledger Nano Hard Wallet.

How to Create a New Account via Mnemonic/Seed Phrase

In the initial pop-up window (or via [Add Account]), choose [Create New Account]. Choose to have a seed/mnemonic phrase of 24 words and save them securely — write the words on paper and store in a secure place. Avoid taking screenshots or storing them on internet-connected devices. Enter a name for your account, then confirm the seed phrase by clicking the words in the correct order.

How to Create a New Account via One-Click Login

Choose the option [Sign in with Google]. Enter the email/phone number and password associated with your Google account. Note: the recommended path is to create an account via Mnemonic phrase or Ledger.

Natively Supported Tokens

The following tokens are natively supported in Keplr and require no additional action: $ATOM (Cosmos Hub), $REGEN (Regen Network), $DVPN (Sentinel), $AKT (Akash Network), $IRIS (IRISnet), $KAVA (Kava), $SCRT (Secret Network), $ROWAN (Sifchain), $IOV (Starname), $CTK (Certik Chain), $CRO (Crypto.com), $OSMO (Osmosis), $XPRT (Persistence), $IXO (IXO).

Suggest Chain Tokens (Non-Natively Supported)

The following tokens are not natively supported but can be added manually: $BTSG (BitSong), $LIKE (LikeCoin), $NGM (e-Money), $ORAI (Oraichain).

How to Deposit Your Tokens

Click on the Keplr icon to open the extension. Select [Deposit] and the wallet will show your address and QR code. Send your tokens to your Keplr address to see them in your available balance.

How to Send Your Tokens

Select [Send] and fill in the Recipient address, Amount, optional Memo (required for some exchanges), and Fee (Low/Average/High). Click [Send] and then [Approve] to complete the transaction.

How to Stake Your Tokens

Select [Stake] on Keplr to be redirected to the web wallet. All active set validators will be displayed. To help decentralization, consider delegating to validators outside the top 10. Select a validator, click [Stake], enter the amount, and [Approve] the transaction.

Claim Rewards & Redelegate

Use [Claim] to reclaim pending staking rewards, [Re-Delegate] to change your validator, or [Undelegate] to remove tokens from staking (subject to a 21-day unbonding period). Always keep a minimum balance available for transaction fees.

Getting Started with Osmosis

⚠️ Keplr is the only wallet integrated with Osmosis DEX. Keplr extension is officially supported only on Chrome and cannot be used from mobile.

Deposit on Osmosis

Before any Osmosis operation, deposit tokens into the Osmosis dashboard. Go to app.osmosis.zone, click [Connect Wallet], then [Assets]. Find your token, click [Deposit], and confirm the IBC transaction via Keplr. Note that depositing is an interchain transaction that may take up to 10 minutes.

Swap Tokens on Osmosis

Click [Trade] on the left. Select the [From] and [To] tokens, enter the amount, and click [Swap]. Confirm the Keplr popup. Note: don't swap all your tokens, as you'll need some for fees.

Provide Liquidity on Osmosis

Click [Pools] and select a pool. Click [Add/Remove Liquidity], enter the amount for one side (the other fills automatically for 50/50 pools), and click [Add Liquidity]. You'll receive LP tokens in return.

Liquidity Mining on Osmosis

To earn LP rewards, bond your LP shares. Click [Pools], select your pool, go to the Liquidity Mining section, click [Start Earning], choose your bonding period (1, 7, or 14 days), and confirm. Longer bonding periods yield higher rewards.

Getting Started with IBC Transfers

⚠️ IBC Transfers are based on a standard under active development. Please approach with care and awareness of the associated risks. Do not send tokens via IBC Transfer directly to a centralized exchange.

On your Keplr Extension, select your source network. In [IBC Transfer], click [Transfer]. Add a new IBC channel by clicking [New IBC Transfer Channel], selecting the destination chain, and entering the channel ID (e.g., channel-141 for Cosmos Hub to Osmosis). Enter the recipient address and amount, then confirm.

How to Vote for Governance Proposals

Go to the Keplr Dashboard and select [Governance] from the navigation for your chosen chain. Active proposals are marked with the [Voting Period] tag. Click [Vote], select your choice (Yes/No/Abstain/No With Veto), set the fee, and click [Approve].

Enable & Mint Secret SCRT with Keplr

SecretSCRT ($sSCRT) is a privacy-preserving fungible Secret Token backed by $SCRT. To create a viewing key: open Keplr, click the menu, select [Add Token], paste the $sSCRT contract address (secret1k0jntykt7e4g3y88ltc60czgjuqdy4c9e8fzek), and click [Create]. To mint $sSCRT: go to the Keplr Dashboard, select [Secret Network], use the [Convert] section to convert SCRT to Secret SCRT, and confirm.

How to Add e-Money Support to Keplr

Go to wallet.e-money.com. A [Chain Add Request] window will appear — click [Approve]. Then authorize the connection in the [Requesting Connection] window. e-Money will now appear under Beta Support in your Keplr networks list.

How to Reserve a *Starname with Keplr

Starname is a NameService that lets you send and receive crypto using simple names instead of long addresses. Go to starname.me, click [Get Started], and log in with Keplr. Choose between Starname Premium Edition (*name) or Basic Edition (name*cosmos). Select your desired name, register it via an on-chain transaction, and then link your crypto addresses and edit your profile in the Starname Dashboard.