Emeris Beta Made Easy: Step-By-Step Tutorial

The era of cross-chain DeFi is here. Experience its power with this informative guide to get you started.

Published in

Emeris Blog

13 min readAug 17, 2021

Emeris Beta has been launched!
Before you dive into the tutorial, if you haven’t already done so, I suggest you read the overview of Emeris Beta written by Gautier MARIN, Director of Product, [Emeris Beta is Live: How to Get Started].

To ensure a stable connection and robust performance, not every chain that is connected via IBC to the Cosmos Hub will be supported immediately at Emeris Beta launch. Only when the team is sure that the relayers of that hub are up and stable, the chain will be integrated with Emeris.

⚠️ Keplr is the only wallet integrated with Emeris beta & Keplr extension is officially supported only by Chrome.
Emeris can also be used with Brave, but some features may be unavailable. Therefore, we recommend using Emeris with Chrome only.
It is not possible to use the Keplr extension from mobile.

⚠️ Pay attention to the websites you connect your Keplr wallet with.
This is the link to Emeris beta, always be extra careful when using search engines to find a website to ensure that you are using the official site

⚠️ Emeris beta does not have an integrated explorer: to monitor your transactions you have to use local chain block explorers: Osmosis, Cosmos Hub, Akash Network, IRIS Hub, Sentinel, Regen Network, Persistence and Crypto.com Chain.

⚠️ What if I don’t have $ATOM?
Emeris beta supports Moonpay.

⚠️ At this moment on Emeris/Gravity DEX Protocol you might experience episodes of high volatility: please trade with caution.

⚠️ If you are swapping on Emeris before using Keplr [Interchain Transfer] feature you must send the obtained tokens back to their native chain via Emeris [Send to Address] option.

⚠️ In case you need support, please get in touch with the team via support form.

⚠️ No one from Emeris, Cosmos, or Keplr teams will ever write you a DM asking to validate your wallet or type your mnemonics:
Please be careful of scammers and if you need help always use the public channel indicated above.

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 appear.
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-hand 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 the Cosmos mainnet address displayed is different from yours when importing the account via mnemonic on Keplr 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 select 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-hand 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 select 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 Mnemonic/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-hand corner, then the blue box [Add Account] & select [Create New Account]

Choose to have a seed/mnemonic phrase of 24 words, then be sure 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 select 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 via Ledger. This procedure is illustrated here only because it 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 select a password you’re not using in any other application, and then click [Confirm]

Go to app.emeris.com
Select [Connect to Keplr].
After carefully reading the terms and conditions, click [Agree] to continue.
Now you have to authorize the connection between Keplr and Emeris:
In the [Requesting Connection] window, select [Approve] to continue.

At launch, Moonpay will only be available in the FIAT>$ATOM path, the reverse feature will be integrated shortly after.
At this time Moonpay only supports $ATOM among IBC integrated tokens.
Please note that Moonpay might require KYC.

Go to [Assets]
Click on [ATOM] and then select [Purchase ATOM] on the left under the swap section. The initial pair is ATOM/USD but you can change the FIAT pair by going to the top left menu and selecting [Default currency].
Write the amount of ATOM you want to purchase (min 30 EUR) and confirm.
Enter your Cosmos Hub address (i.e. cosmosxxxxxxxxxxxxxxx…..).
If you’re sending to your Keplr wallet connected to Emeris, [tag] isn’t mandatory.
Enter your email address
You will receive a verification code: fill the dedicated section and select [Continue]
Now you have to give Moonpay some basic details such as First Name, Surname, Date of Birth, and Country of Nationality to continue.
Billing address section, so Address, City, PostCode, and Country
Add a payment method & confirm the card billing address
Enter the card details like Card Number, Expiry Date, and Card Security Code
Complete the process and your FIAT gateway is ready!

You have two options:
[Send to Address] and [Move Assets].

The first one will send tokens to addresses outside your account, the second one will move tokens from one address to another in the account you are currently using [ the one linked via Keplr wallet].

Send to Address

Enter the address to which you want to send your tokens, keep in mind to complete the memo field if the recipient is an exchange.
After checking that the data is accurate, check the box and click [Continue].
Choose the type of tokens you want to send and enter the amount.
Click [Continue].
Select [Confirm and continue] and the [Approve] in the Keplr pop-up.

Move Assets

Choose the type of tokens you want to send and enter the amount.
Select the starting chain and the destination chain.
Click on [Continue] twice.
Select [Confirm and continue] and the [Approve] in the Keplr pop-up.

Note:
• If you want to receive mainnet tokens into your account via Emeris:
In the upper-right-hand corner, click on [Receive], select the token you want to deposit and you will be able to view the QR code/public address needed to complete the transaction.
The deposit is available only via mainnet (i.e. ATOM to Cosmos Hub, AKT to Akashnet, etc.)
• It is strongly recommended that you keep enough tokens [available] to cover at least 2–3 transactions per mainnet.
Transaction costs should be around $0.04–0.18.

The [Swap] section is located in the upper-right-hand corner of the [Portfolio] page.

Select the token you want to swap
If you have this token in several chains, Emeris will ask you which one you want to use.
If the tokens are not in the Cosmos Hub, Emeris will first perform an interchain transaction to bring the tokens into the hub and then add the tokens to the pool. You will need to [Confirm and continue] on Emeris first and then on Keplr to complete the transfer.
Select the token you wish to obtain through this swap. You can get LP tokens as well.
Note that the tokens obtained from the exchange will be located in the Cosmos Hub.
Write down either how many tokens you want to exchange or how many tokens you want to receive.
Click [Review]
Select [Confirm and Continue]
A popup of Keplr will now appear asking you to approve the operation by clicking [Approve].
Select [Done] on Emeris to complete.

Note:
• Tokens obtained from the swap will be located in the Cosmos Hub, if you want to move mainnet tokens to their chains, you must do so via interchain transaction.
• Since the market is extremely volatile, the displayed value may change by the time you confirm your trade. If you want to make sure that the amount of tokens you receive does not differ too much from expected, you can change the [Slippage] by clicking on the 3 dots at the top right of the [Swap] section. There you have 3 options: [0.1%] [0.5%] and [1%] which represent the percentage of tolerance you are willing to accept in completing the operation. If the system determines that it is impossible to execute the operation because the value of the tokens has changed, the operation will be canceled.
• Don’t swap all the tokens you have, there are fees to pay for doing so and if you don’t take this into account, your operation will fail.

In order to provide liquidity, you will need to have both sides of the pair.
If you want to provide liquidity in the [ATOM:OSMO] pool you will need to have some $ATOM and some $OSMO, to provide liquidity in the [ATOM:IRIS] pool you will need both $ATOM and $IRIS, and so on.
Remember that when we talk about percentage we are referring to the value (i.e. $10 each) and not the number of the tokens.

Go to the [Pools] section
Click on the pool you wish to add tokens to
Select [Add Liquidity] on the right (Equity section)
Indicate the desired amount of tokens.
Once the amount of one of the two tokens is indicated, the other will automatically be filled by the system.
Select [Continue]
If the tokens are not in the Cosmos Hub, Emeris will first perform an interchain transaction to bring the tokens into the hub and then add the tokens to the pool. You will need to [Confirm and continue] on Emeris first and then on Keplr to complete the transfer.
A pop-up of Keplr extension will appear asking you to approve the operation by selecting [Approve].

Once the procedure has been successfully completed, it will be possible to visualize the summary of the operation.
Providing liquidity to the pool, you have obtained LP Tokens called [Gravity X](the number varies as it is associated with a specific pool).

Note:
• If you want to remove the liquidity you have placed in the pool, go to [pools] page, select the pool you want to remove the liquidity from, click on [Withdraw].
Now you can choose how much to withdraw (whether all or part of it) from the pool by using the LP tokens in your possession. For simplicity, at the bottom, you will find how much percentage of the pool corresponds to the tokens you want to withdraw.
• If you want to create a pool, go to the [Pools] page, select on the side [+ add liquidity] and select the two tokens you want as pairs. A message will be displayed [You are the first liquidity provider. As the first liquidity provider to the AKT / XPRT pool, you will be creating the pool and setting the price. Proceed with caution].
Click on [Confirm] >[I understand] > [continue] and [proceed and continue].
• Liquidity provision is not without costs.
LPs take on a risk known as impermanent loss. You can read more on [Emeris FAQ].
• The Cosmos Hub does not currently support farming incentives.
However, a Cosmos SDK module is currently being developed for this purpose. The Hub community may submit a proposal to upgrade to the farming module and enable farming incentives for the Gravity DEX. We will report on the readiness of the farming module and the proposal as we get further information.