All pages
Powered by GitBook
1 of 10

Get Started

How to Connect Wallet

🐨 KoalaSwap — How to Connect Wallet via MetaMask (If Not Installed) 1. Let's go to the Koalaswap website.

2. Then, click on the button “Connect” or “Connect wallet”.

3. In the modal window that opens, select “MetaMask”.

4. Next we are transferred to the MetaMask installation page. Click "install".

5. Next, you need to create a wallet in MetaMask or import an existing wallet. If you have any difficulties creating one, read the instructions on the website https://support.metamask.io/ru/start/getting-started-with-metamask/

6. After installing MetaMask, go to the KoalaSwap website, close the modal window.

And reload the page.

7. Again click on “Connect” or “Connect wallet”

The wallet will automatically connect to the site and add Unit Zero Mainnet network.

In case the network was not added automatically, it can be added manually via https://chainlist.org/chain/88811 (ChainID 88811).

8. After successful connection, the wallet address will be displayed in the upper right part of the screen

How to Swap Tokens

🐨 How to Swap Tokens on KoalaSwap

Token swapping is the process of exchanging one cryptocurrency for another through a decentralized liquidity pool — all without an intermediary.

1) Make sure you are connected to your wallet. 2) Select Tokens

  • In the Sell field, choose the token you want to swap (e.g., UNIT0)

  • In the Buy field, click "Choose a token" and select the token you want to receive (e.g., USDT, USDC, etc.)

Enter Amount

  • Enter how much you want to sell

  • The system will calculate how much you’ll get in return

  • And Click "Review"

3) Final Step At the bottom:

  • Check the box: “You confirm that you are performing the operation at your own risk.”

  • Then click Swap to complete the transaction.

  • Confirm the transaction in your wallet (MetaMask, etc.)

  • Wait for the swap to finalize. Your new tokens will appear in your wallet.

How to Provide Liquidity

🐨 KoalaSwap — Liquidity Provision Guide

How to add liquidity from all available pages & flows

✅ Case 1: Adding liquidity to a pool (no existing position) via https://koalaswap.app/explore/pools

🔹 Scenario: You don’t have an existing position and want to join an existing pool.

📍 Steps:

  1. Go to the Pools page

  2. Locate your desired pair (e.g., WBTC / WUNIT0)

3. Click the pool row to open the overview modal 4. Click “+ Add Liquidity”

5. Set: Price range (or choose "Full Range") Token amounts

6. Confirm in your wallet

🐨 You’ll create a brand new position in this pool, tailored to your parameters.

✅ Case 2: Adding liquidity to an existing position via /positions

🔹 Scenario: You already have a position and want to increase liquidity in it.

🔸 Option A: From the three-dot menu (⋮)

  1. Go to the Positions page

  2. Find the position you want to add to

  3. Click the ⋮ icon

  4. Select “Add Liquidity”

  5. Input token amounts → Confirm

💡 Quick and efficient for experienced users.

🔸 Option B: From the detailed position page

  1. Go to the Positions page

  2. Click on the position row to open its detail view

  3. Click “+ Add Liquidity”

4. Set token amounts and confirm

🧠 Ideal if you want to review the price range, earned fees, and other details first.

✅ Case 3: Step 1: Open the Pool Page

Go to the Pool Page and click "Add Liquidity".

Step 2: Select a Token Pair

  • On the left side, choose the first token (e.g., UNIT0).

  • On the right side, click "Choose a token" and select the second token from the list.

💡 You can use any tokens available on your connected network. Make sure you have enough balance for both.

Step 3: Choose a Fee Tier

Select one of the available options:

Fee Tier

Best For

0.01%

Very stable pairs (e.g., stablecoins)

0.05%

Mostly stable pairs

0.3%

Default choice for most pairs

1%

Volatile or exotic token pairs

Step 4: Click "Continue"

Once you’ve selected the tokens and fee tier, the "Continue" button will become active. Click it to proceed.

Step 5: Full Range

✅ Covers the entire price spectrum — from 0 to ∞. ✅ Your liquidity is always active, regardless of price movement. Min Price = 0, Max Price = ∞ — cannot be changed. Custom Range Define the specific price window where your liquidity will be active. You set: Min Price: The lowest price at which your liquidity is active Max Price: The highest price at which your liquidity is active Continue Button Once you’ve selected a range click "Continue" to move on to the next step: entering token amounts and confirming the transaction.

Step 6: In this step, you’ll specify the token amount to deposit and confirm the transaction via your wallet. Deposit Tokens Section This is where you specify how much liquidity you want to provide.

What to do:

  1. Enter the desired amount of tokens. For example: 5 Or click "Max" (next to your available balance, e.g. 14.90) to use the full amount.

  2. Once entered: The “Review” button will become active.

Step 7: In the next modal window click the Create button

🐨 KoalaSwap — Guide: How to Collect Fees

📍 When to use?

  • You have an active position that has earned fees

  • The Uncollected fees section shows non-zero values

🔸 Option 1: From the Positions List (via ⋯ Menu)

  1. Visit https://koalaswap.app/positions

  2. Find your active position

  3. Click the ⋯ (three dots) at the end of the row

  4. Choose Collect fees from the menu

  5. Confirm the transaction

  6. ✅ Fees successfully collected

🔸 Option 1: From the Position Details Page

  1. Go to the Positions page https://koalaswap.app/positions

  2. Click on your position This will open the details view for that LP position.

  3. Check the “Uncollected fees” section It displays how much fee you’ve earned in each token.

  4. Click the "Collect fees" button

  5. Confirm the transaction in your wallet Sign and pay gas fees to receive the rewards.

  6. ✅ Done! The tokens will be transferred to your wallet.

🐨 KoalaSwap — Guide: How to Remove Liquidity

📍 When to use?

  • You want to partially or fully withdraw your tokens from a position

  • You're closing or rebalancing your liquidity

🔹 Two Ways to Remove Liquidity

🔸 Option 1: From the Positions List (via ⋯ Menu)

  1. Visit https://koalaswap.app/positions

  2. Locate your position in the list

  3. Click the ⋯ (three dots) on the right side of the row

  4. Select Remove liquidity from the dropdown

  5. Follow the steps to set the amount and confirm

  6. ✅ Liquidity successfully removed

🔸 Option 2: From the Position Details Page

  1. Go to the Positions page https://koalaswap.app/positions

  2. Select the position you want to edit Click on the pair to open its details.

  3. Click the “Remove liquidity” button It’s in the top right corner of the position page.

  4. Choose how much liquidity to remove You can select a percentage (e.g., 25%, 50%, 100%) or enter a custom amount.

  5. Confirm the action Click Confirm and approve the transaction in your wallet.

  6. ✅ Done! The withdrawn tokens will appear in your wallet, and your position will be updated.

Pools Page

🐨 KoalaSwap — Pools Page

The Pools page on KoalaSwap displays a list of available liquidity pools. These pools are the foundation of token swaps on the decentralized exchange. Users can provide liquidity to earn fees from trades that occur within the pool.

• Pool Displays the token pair in the liquidity pool. Example: USDT / WUNIT0 — this means the pool contains both tokens, and users can trade between them. Token icons and names make identification easier.

• Protocol Shows the version of the liquidity protocol used by the pool. Currently, KoalaSwap uses the KoalaSwap V3 protocol

• Pool Price The current exchange rate between the two tokens in the pool. Example: 1 USDT = 6.612 WUNIT0 — means that for each USDT, a user will receive ~6.612 WUNIT0.

• Fee The fee charged per swap in this specific pool. Example: 0.3% — indicates that 0.3% of each transaction is taken as a fee and distributed to liquidity providers based on their contribution.

• TVL (Total Value Locked) The total dollar value of tokens held in the pool. This metric reflects the overall liquidity depth. Higher TVL means lower slippage, more stable prices, and greater trader confidence.

Pool Detail Page

🐨 KoalaSwap — Guide to the Pool Details Page

📍 Example: USDT / WUNIT0 (0.3%) 🔗 This page appears when you click on a specific pool


🔎 What’s shown on the Pool Details page?

📊 Pool Activity Chart

Displays the distribution of liquidity or trading volume by day.

  • X-axis — Dates

  • Y-axis — Values (e.g., volume traded)

🔁 Action Buttons

Located in the top right corner:

  • Swap — Swap tokens directly in this pool

  • Add liquidity — Add liquidity to this pool

📈 Stats Section

  • Pool balance — current token amounts in the pool:

    • 12,474.46 USDT

    • 91,522.43 WUNIT0

  • TVL (Total Value Locked) — total pool value in USD (e.g., 19.41K)

  • 24H Volume — trading volume over the last 24 hours

  • 24H Fees — fees collected in the last 24 hours

🔗 Links (Contract Addresses)

  • Pool contract: USDT/WUNIT0

  • Token contracts: USDT and WUNIT0

You can copy these addresses to explore in a block explorer (e.g., Etherscan).


💱 Transactions (Transaction History)

Each entry includes:

  • Transaction hash (clickable link)

  • Timestamp

  • Action type

  • Amount in USD and tokens

  • Wallet


🧠 Tips

  • Use the Add liquidity button if you want to deposit tokens directly into this specific pool

  • Check TVL and volume to understand how active the pool is

  • Transaction history helps you see which types of activity (swaps, adds, removals) happen most often

  • Always double-check token and pool contract addresses before interacting

Transactions Page

🐨 KoalaSwap – Transactions Page The Transactions page on KoalaSwap displays a list of the most recent token swap transactions made through the decentralized exchange. Users can see which tokens were swapped, the amounts, and other essential details.

📊 Table Columns Explained • Hash The transaction hash — a unique identifier for the transaction on the blockchain. Clicking it usually opens a blockchain explorer where you can view full transaction details.

• Time The time elapsed since the transaction was completed. For example, "11m 27s" means the transaction occurred 11 minutes and 27 seconds ago.

• Type The type of operation. This field always shows Swap, indicating that a token-to-token exchange was performed.

• USD The approximate value of the transaction in US dollars at the time of the swap. This value is calculated based on the exchange rate at the moment of execution.

• Token amount (1) The amount of tokens sent in the transaction. For example: 9.65 USDT.

• Token amount (2) The amount of tokens received in return. For example: 63.80 WUNIT0.

• Wallet The wallet address that initiated the transaction. This address is shown in a shortened format, displaying only the first and last characters (e.g. 0x7e0...82e2) for readability.

Positions Page

🐨 KoalaSwap — Positions Page 📌 Who is this page for?

  • Users who have already added liquidity

  • Those who want to create their first position

  • Anyone looking to manage (increase, withdraw, or monitor) their LP positions

📍 If You Have No Positions Yet

You’ll see this screen:

Click the "Create" button Opens the form to create a new LP position. You'll choose a token pair, set the price range, amount, and provide liquidity.

A modal will open where you:

Step 1: Select a Token Pair

  • On the left side, choose the first token (e.g., UNIT0).

  • On the right side, click "Choose a token" and select the second token from the list. 💡 You can use any tokens available on your connected network. Make sure you have enough balance for both.

Step 2: Choose a Fee Tier

Select one of the available options:

Fee Tier

Best For

0.01%

Very stable pairs (e.g., stablecoins)

0.05%

Mostly stable pairs

0.3%

Default choice for most pairs

1%

Volatile or exotic token pairs

Step 3: Click "Continue"

Once you’ve selected the tokens and fee tier, the "Continue" button will become active. Click it to proceed.

Step 4: Full Range ✅ Covers the entire price spectrum — from 0 to ∞. ✅ Your liquidity is always active, regardless of price movement. Min Price = 0, Max Price = ∞ — cannot be changed.

Custom Range Define the specific price window where your liquidity will be active. You set: Min Price: The lowest price at which your liquidity is active Max Price: The highest price at which your liquidity is active

Continue Button Once you’ve selected a range click "Continue" to move on to the next step: entering token amounts and confirming the transaction.

Step 5: In this step, you’ll specify the token amount to deposit and confirm the transaction via your wallet. Deposit Tokens Section This is where you specify how much liquidity you want to provide.

What to do:

  1. Enter the desired amount of tokens. For example: 5 Or click "Max" (next to your available balance, e.g. 14.90) to use the full amount.

  2. Once entered: The “Review” button will become active.

Step 6: In the next modal window click the Create button

Done

📍 If You Already Have Positions

Use this flow if:

  • You’ve already created one or more liquidity positions

  • You want to manage existing positions — add or remove liquidity, or adjust the price range

  • You prefer to monitor and control all your positions in one place via the Positions dashboard

🔘 Token Pair & Fee Tier

  • Example: USDT / WUNIT0 0.30%

  • This shows the pair of tokens in the position and the selected fee tier.

  • The fee tier indicates the percentage of trading fees earned from swaps in this pool (e.g. 0.30%).

🟢 Status: In Range / Out of Range

  • In Range (green dot): Your liquidity is currently being used in the pool. You're earning fees.

  • Out of Range (red/gray dot, not shown here): The market price has moved outside your defined price range, and your liquidity is inactive (no fees earned).

🆔 Position ID

  • A unique identifier (e.g. ID 19) for each liquidity position.

  • Useful for referencing or removing positions.

💧 Liquidity

  • Shows how much of each token you currently have in the position.

  • Example:

  • 0.00 USDT

  • 4.9999999 WUNIT0

  • Liquidity may not be equally split — it depends on your price range and market price.

📈 Current Price

  • Displays the current on-chain exchange rate for the token pair.

  • Example: 0.99999736 USDT/WUNIT0

🔢 Price Range

This is the range of prices where your liquidity is active:

  • Min: Lowest price at which liquidity is still used.

  • Max: Highest price within the range.

  • If listed as “Full range”, your liquidity is available at any price, but this strategy may have a lower yield and higher impermanent loss.

🐨 KoalaSwap — Guide to the Position Details Page

📍 Example: USDC / WUNIT0 (0.30%) Position

🔍 What’s Shown on This Page?

💧 Liquidity (Your deposited tokens)

Displays the amount of each token currently in the position:

  • USDC: 8.574461

  • WUNIT0: 5.4058671 This is your active liquidity in the pool.

💰 Uncollected Fees

Shows how much fee income you've earned but haven't claimed yet:

  • USDC: 0.00

  • WUNIT0: 0.00231883 👉 Click Collect fees to claim these tokens to your wallet.


💵 Price Range

Shows the price range in which your position is active:

  • Min price: 0.00

  • Max price: ∞

  • Current price: 0.63046144 WUNIT0 per USDC ⚠️ The label “In range” means your position is currently earning fees.


⚙️ Action Buttons

  • Add liquidity — Add more tokens to this position

  • Remove liquidity — Withdraw part or all of your liquidity

  • Collect fees — Claim any earned but uncollected fees

🧠 Tips

  • Make sure your position is “In range” to earn fees

  • Use Collect fees regularly to claim rewards

  • To change the price range, you need to remove this position and create a new one

  • You can add or remove liquidity partially — it's flexible

Tokens Page

🐨 KoalaSwap — Tokens Page The Tokens on KoalaSwap page displays all tokens available within the KoalaSwap ecosystem. It provides a detailed view of each token’s performance and key metrics, helping users make informed decisions about trading, liquidity provision, or research. 📋 What’s on the Tokens Page? Each row in the table represents a token, along with useful trading and liquidity data.

🔘 Navigation Tabs

At the top, you’ll see three navigation options:

POOLS — View liquidity pools. TRANSACTIONS — Review recent activity/swaps. TOKENS — The current view, showing a list of tokens and statistics.

🔍 Search Bar

Enter token name — Allows you to filter tokens by name or symbol 📊 Token Table Each row in the table represents a single token. The following columns are included:

• Token name The name and logo of the token (e.g., Wrapped UNIT0, Test USDC).

• Price Current market price of the token (e.g., $1.00, $0.66).

• TVL (Total Value Locked) Total value locked in liquidity pools containing this token — an indicator of ecosystem trust and usage.

• Volume Trading volume over a recent period — shows activity and demand.

• FDV (Fully Diluted Valuation) The projected market cap assuming all tokens are in circulation — a measure of full potential valuation (e.g., $661.95B).

Token Detail Page

🐨 KoalaSwap — Token Detail Page

The Token Page is your central hub for everything related to a specific asset. Here, you can analyze price charts, view liquidity pools, track trading volume, and quickly execute swaps. Example: WUNIT0 (Wrapped UNIT0) 📈 Price Chart

Displays the token’s price trend over recent days.

  • 🐨 Vertical axis — Price

  • 📆 Horizontal axis — Date

🔄 Swap Box

Located on the right side of the page — enables instant buy/sell operations:

  • 🐨 Sell / Buy — Input fields for amount

  • 🔁 Direction Switcher — Flips token pair direction

  • 🧮 Review — Previews the transaction before confirmation

📊 Token Stats

  • 💧 TVL (Total Value Locked) — Total liquidity in USD → Higher TVL = safer trading and less slippage

  • 🧮 FDV (Fully Diluted Valuation) — Market cap if all tokens were in circulation → Useful for assessing the project’s full scale

  • 🔄 1 Day Volume — Trading volume over the last 24 hours → Helps evaluate market activity

🧠 Info Block

  • 🧾 Token address — With a convenient copy button

  • 🔍 Explore — Opens the token in a blockchain explorer

  • 🛡️ Use this to verify contract authenticity

🧪 Pools

Below you’ll see a list of all active pools that include this token.

Field
Description

Pool

Name of the pool (e.g., USDT/WUNIT0)

Protocol

Protocol version (e.g., v3)

Pool price

Exchange rate in this pool

Fee

Pool fee (e.g., 0.30%)

TVL

Liquidity in the pool (in USD)

Click the pool name to go to its detailed view. TRANSACTIONS Tab

Shows the latest trades involving the token. Use it to monitor activity and detect large movements.