Skip to main content

Get Started

For this tutorial, we will be using the Aleph Zero blockchain. There may be slight differences in usage between different chains, so we encourage you to check the Get Started docs specific to the blockchain you are using in Supported Blockchains tab.

This guide will walk you through the essential steps to get started on our platform, from connecting your wallet and requesting an airdrop to adding a liquidity position, swapping tokens, claiming fees, and closing your position. If you encounter any issues, check out the more detailed User Guide. If you have any questions, feel free to join our community on Invariant's Discord for support. Please note that this walkthrough is on the testnet.

Connect your wallet

To begin using Invariant, you'll need to connect your wallet. Follow these steps:

  1. Click on the "Connect wallet" button at the top right corner of the page or or in the swap area. Connect wallet

  2. Select your wallet provider (we highly recommend using Nightly). Nightly

  3. Follow the prompts to authorize the connection, and you are ready to go with your wallet connected.

Request airdrop from Aleph Zero Faucet

To start interacting with the Invariant platform on the Aleph Zero testnet, you will need some testnet tokens. You can request these tokens from the Aleph Zero Faucet.

  1. Open your web browser and navigate to the Aleph Zero Faucet page.

A0 Faucet

  1. Open your Nightly wallet.

Nightly wallet

  1. Remember to switch your wallet to the Aleph Zero Testnet. You can find the full instructions on how to do it here.

  2. Copy your wallet address to clipboard.

Nightly wallet

  1. Paste your wallet address in Aleph Zero Faucet and solve the captcha.

Paste adress

  1. Click “Make it rain” button.

After few second, airdrop of testnet AZERO should be in your wallet.

Request airdrop from Invaraint Faucet

Now that you have testnet tokens to approve transactions on the Aleph Zero Testnet, you can request an airdrop from Invariant. You will receive testnet BTC, ETH, and USDC.

  1. Click the "Faucet" button on Invariant site.

Buttons

  1. Approve transaction in your wallet

Approve transaction

  1. After a while, you should have airdropped tokens in your wallet.

Add liquidity

Adding a liquidity position allows you to earn fees from trades on the Invariant DEX. To add a position follow these steps:

  1. Go to the "Liqudity" tab and click on "Add Position" button.

Add position

  1. Choose the tokens you want to provide liquidity for.

Select tokens

  1. Select fee tier. The fee tier determines the percentage of tokens deducted from a user who makes a swap, thus defining the amount of fees you will earn when a user utilizes your liquidity in the swap. Each fee tier represents a different liquidity pool.

Fee tier

  1. Specify the price range within which you want to provide liquidity This range determines where your tokens will be active in the market. You will earn fees only when trades occur within this range. Adjust the min and max price sliders to set your range.

Price range

  1. Enter the amount you want to contribute to the liquidity pool. Please note that you need to provide both tokens in the correct ratio.

Deposit amount

  1. Click "Add Position" button

Exchange tokens

Now you can use testnet tokens, that you received form Airdrop. This point will show you how to perform swap with this tokens.

  1. Navigate to "Exchange tab".

  2. Select the tokens you wish to swap. A modal will appear where you can choose a specific token by either entering its name or selecting one from the list. Additionally, you can add a token by clicking the plus button and providing its token address. In this example, we're swapping from AZERO to USDC.

Swap

  1. Enter the amount of tokens you want to swap. To swap all tokens from your wallet, simply click “Max”.

Swap

  1. Click "Exchange" and confirm the transaction in your wallet. Your swapped tokens will appear in your wallet once the transaction is completed.

Potential problems:

  • Insufficient balance - this means that your balance is smaller than the amount of tokens you want to swap. To fix this, try swapping fewer tokens.

Swap

  • Insufficient liquidity - this means that there is not enough liquidity in the pool to perform your swap. To fix this, add more liquidity or decrease the amount of tokens you want to swap.

Swap

  • Insufficient volume - this means that you probably did not enter any tokens in the exchange window.

Swap

Claim fees

As a liquidity provider, you can claim your earned fees. To claim fees:

  • Navigate to the "Liquidity" section and open the position from which you want to claim fees.

  • Click on "Claim Fee" to initiate the transaction.

Claim fees

  • Confirm the transaction in your wallet.
  • Your claimed fees will be added to your wallet balance.

Close position

If you want to close your position and remove liquidity, you can do this even if your fees are unclaimed. The fees after closing the position will be sent to your wallet along with the liquidity.

  • Navigate to the "Liquidity" section and open the position which you want to close.

  • Click "Close Position" and confirm the transaction in your wallet. Deposited tokens as well as unclaimed fees will be transferred to your wallet

Position details