How To Use the Gravity Bridge Portal

A new version of the Gravity Bridge Portal is in the works!
Stay tuned for its release in Q1 2022!

With the upcoming deployment of the Gravity bridge module on the Cosmos Hub, we will finally be able to transfer assets between Ethereum and Cosmos. We at blockscape wanted to celebrate this cosmic milestone by contributing something to the user experience — behold, the Gravity Bridge Portal.


Setting Up Wallets

  1. Unlock your Metamask and Keplr wallets.
  2. Select Goerli Test Network in Metamask.
  3. Go to
  4. Approve the addition of the chain to your Keplr wallet.
  5. Use the buttons in the app bar on the top right to connect your wallets.
  6. In Keplr, select the newly added chain (current: althea-testnet2v3) in the dropdown on the top.
  7. If you don’t already have an account/address in Keplr, please create one.
  8. Get ALTG token from Althea’s faucet. Open up a terminal and use the following command:
    curl -vv -XPOST
  9. In Metamask, select the Goerli Test Network in the dropdown on the top.
  10. If you don’t already have an ERC-20 account/address in Metamask, please create one.
  11. Make sure you have enough GöETH on your address. You can either open up a terminal and use…
    curl -vv -XPOST
    …or, you can use the authenticated faucet.

Getting ERC-20 Tokens

For the purpose of this demo, we will be using a bunch of Görli test tokens. You can choose any one you like:

  • WEENUS — 0xaFF4481D10270F50f203E0763e2597776068CBc5
  • XEENUS — 0x022E292b44B5a146F2e8ee36Ff44D3dd863C915c
  • YEENUS — 0xc6fDe3FD2Cc2b173aEC24cc3f267cb3Cd78a26B7
  • ZEENUS — 0x1f9061B953bBa0E36BF50F21876132DcF276fC6e

Then, please follow the instructions below.

  1. Open Metamask, and click on “Send”.
  2. Paste any one of the token contract addresses from above into the field.
  3. Make sure “Amount” says “0 ETH”, and click “Next”.
  4. Click “Confirm”.
  5. Switch to the “Assets” tab, scroll down and click “Add Token”.
  6. Paste the token contract address you chose in step 2 into the “Token Contract Address” field.
  7. Click “Next”.

By now, you should have received 1,000 of your chosen tokens. If you don’t want to use any of the test tokens listed above, you can also deploy your own ERC-20 token on the Görli testnet.

ERC-20 to Cosmos

Gravity Bridge Portal: ERC-20 to Cosmos Transfer
  1. Token contract address
    The contract address of the ERC-20 token you want to send to Cosmos. Assuming, you have gotten one of the tokens mentioned in the beginning of this article, you can either select that one here, or paste in any other token contract address of your choice.
    (As there’s only a Görli testnet deployment, only ERC-20 tokens deployed on Görli can be sent over the bridge.)
  2. Amount
    The amount of the ERC-20 token specified in “Token Contract Address” you would like to send to Cosmos.
  3. Cosmos destination address
    The Cosmos address that should receive the ERC-20 token. The address must be an althea1… address.

Cosmos to ERC-20

Gravity Bridge Portal: Cosmos to ERC-20 Transfer
  1. Denom
    The denominator of the Cosmos token you want to send to Ethereum. Choose which one you want to send from the dropdown.
  2. Amount
    The amount of the Cosmos token specified in “Denom” you want to send to Ethereum.
  3. ERC-20 destination address
    The Ethereum address that should receive the Cosmos token on the Goerli testnet.

And that’s it for this guide, we hope you found it helpful and had some fun sending tokens back and forth with the Gravity Bridge Portal! Until next time!

Validator operator in 15+ PoS blockchains. Visit us at