feat/RDOC-46

docs/apps/katana/guides/farm.mdx

@@ -0,0 +1,82 @@
+---
+description: Stake your liquidity pool tokens to earn RON.
+slug: /apps/katana/farm
+title: Farm
+---
+
+## Overview
+
+You can stake liquidity pool (LP) tokens on Katana to farm RON. Farming is the process of providing liquidity to a pool and earning farm rewards in return. The farm rewards are distributed in the form of RON tokens. The more LP tokens you stake, the more RON you earn. Farming is available for a limited number of pools at any given time. You can see the list of pools that offer farm rewards by turning on the **Farms only** filter on the **Liquidity pool** page.
+
+## Prerequisites
+
+To farm RON on Katana, you need to have LP tokens in a pool that distributes farm rewards. To add LP tokens to a pool, see [Add a liquidity pair](pool.mdx#add-a-liquidity-pair).
+
+## Start farming
+
+1. Open [Katana](https://app.roninchain.com/swap) and connect your Ronin Wallet.
+2. Select the **Liquidity pool** page, then turn on the **Farms only** filter to show the pools that offer farm rewards. All farming pools have a visual indicator with the lightning and RON symbol to the right side of the pool name.
+
+    ![Show farms only](../assets/katana-farm-filter.png)
+
+3. Select the pool you want to farm RON from, then click the **Farm rewards** tab, and then select **Stake**. This opens the **Stake** panel for staking your LP tokens. In the **My position** panel, you can see how many tokens you have staked and how many are available in your wallet.
+
+    ![Stake panel](../assets/katana-farm-stake-panel.png)
+
+    **Note:** If you interact with the LP token for the first time, you need to approve it. Click **Approve**, then confirm the transaction in your Ronin Wallet.
+
+6. Enter the amount of LP tokens you want to stake. You can also click **Max** to stake the maximum amount of LP tokens you have in this pool. When you're ready, click **Stake** and confirm the transaction in your Ronin Wallet.
+
+    ![Enter stake amount](../assets/katana-farm-stake-amount.png)
+
+Your transaction is now submitted to the blockchain. When it completes, Katana displays a confirmation pop-up. Close it or click **View on explorer** to see the detailed information about the transaction.
+
+![Successful staking](../assets/katana-farm-stake-success.png)
+
+After staking, you can see an update in your total LP tokens staked and available in wallet.
+
+![Position after staking](../assets/katana-farm-stake-position.png)
+
+Congratulations, you are now farming RON on Katana.
+
+## Claim farm rewards
+
+### Claim from the My positions tab
+
+Open the **Liquidity pool** page, then select **My positions**, and then click **Claim** next to the pool you want to claim rewards from.
+
+![Claim from My positions](../assets/katana-farm-positions-claim.png)
+
+### Claim from the Farm rewards tab
+
+Select the pool to claim rewards from, then open the **Farm rewards** tab, and then click **Claim all**.
+
+![Claim from individual pool](../assets/katana-farm-individual-claim.png)
+
+After clicking either of the buttons, confirm the transaction in your Ronin Wallet.
+
+When the transaction completes, Katana displays a confirmation pop-up. Close it or click **View on explorer** to see the detailed information about the transaction.
+
+![Successful claim](../assets/katana-farm-claim-success.png)
+
+## Stop farming
+
+To stop farming, you need to unstake the LP tokens from a farm pool. Unstaking means that you stop receiving RON proportionate to how much LP tokens you unstake.
+
+1. Select the pool you want to unstake from, then click the **Farm rewards** tab, and then select **Unstake**. This opens the **Unstake** panel for unstaking your LP tokens.
+
+    ![Unstake panel](../assets/katana-farm-unstake-panel.png)
+
+2. Enter the amount of LP tokens you want to unstake. You can also click **Max** to unstake all your LP tokens. When you're ready, click **Unstake** and confirm the transaction in your Ronin Wallet.
+
+    ![Enter unstake amount](../assets/katana-farm-unstake-amount.png)
+
+Your transaction is now submitted to the blockchain. When it completes, Katana displays a confirmation pop-up. Close it or click **View on explorer** to see the detailed information about the transaction.
+
+![Successful unstaking](../assets/katana-farm-unstake-success.png)
+
+After unstaking, you can see an update in your total LP tokens staked and available in wallet reflective of the changes you made.
+
+![Position after unstaking](../assets/katana-farm-unstake-position.png)
+
+Congratulations, you have successfully stopped farming RON on Katana.

docs/apps/katana/guides/pool.mdx

@@ -0,0 +1,128 @@
+---
+description: Provide liquidity to Katana and earn swap fees.
+slug: /apps/katana/pool
+title: Pool
+---
+
+## Overview
+
+You can contribute funds to liquidity pools (LP) on Katana, enabling you to earn trading fees from the resulting
+transactions.
+
+By engaging as a liquidity provider, you deposit pairs
+of tokens into a smart contract, effectively increasing the pool's liquidity.
+
+For example, if you decide to support the WETH-AXS pool, you need to
+contribute an equivalent value of both tokens. Say the value of 1 WETH is USD 3,200.00 and the value of 1 AXS is USD 7.70. If you want to provide 1 WETH into the WETH-AXS pool, you also need to provide around 415 AXS.
+
+In recognition of your
+contribution, you receive _liquidity pool tokens_, which represent your share in the pool.
+
+These tokens not only signify your stake but also entitle you to a portion
+of the trading fees generated by the pool's transactions, directly
+proportional to your contribution. These fees are added to pool and accrue in real-time. You can claim them by withdrawing your liquidity.
+
+Be aware that earning a profit through providing liquidity isn't guaranteed.
+You may face what's known as _impermanent loss_, a risk that arises from
+fluctuations in the value of the deposited tokens.
+
+## Prerequisites
+
+To provide liquidity on Katana, you need to have tokens in your Ronin Wallet. You can acquire tokens by depositing from Ethereum using [Ronin Bridge](https://app.roninchain.com/bridge), buying tokens through the [Purchase](https://purchase.roninchain.com) website, or receiving tokens from other users.
+For more information, see [Acquire RON](../../../basics/acquire-ron.mdx).
+
+## Add a liquidity pair
+
+1. Open [Katana](https://app.roninchain.com/swap) and connect your Ronin Wallet.
+2. Select the **Liquidity pool** page. You can see a list of available pools, each consisting of two tokens.
+    ![Liquidity pool](../assets/katana-pool.png)
+
+3. Search for the pool you want to contribute to, then select it. You can search by the token's symbol or name.
+
+    ![Search for RON](../assets/katana-pool-search.png)
+
+    This opens the **Liquidity pool** tab with a token pair panel for providing liquidity. It looks similar to the swap panel, except you see a plus sign (+) between the two tokens instead of an arrows sign. This symbolizes that you are adding both tokens into a pool.
+
+    ![Add liquidity panel](../assets/katana-pool-add-liquidity.png)
+
+    The other information about the pool includes the following:
+    * **My position**: the amount of LP tokens you have in the pool and the ERC20 tokens you contributed. The values are zero if you haven't contributed yet.
+    * **Fee earned**: the fees earned from asset trading in this pool.
+    * **Total value locked**: the total value of the pool, including the volume, fees, and transactions for the last 24 hours. 
+    * Charts showing the pool's performance over time: volume, total value locked, and fees.
+
+5. Enter the amount of tokens you want to contribute. Katana automatically calculates the equivalent amount of the other token based on the current exchange rate. You can also click **Max** to deposit the maximum amount of tokens you have in your wallet. If everything checks out, click **Add**.
+
+    ![Enter amount](../assets/katana-pool-enter-amount.png)
+
+    **Note:** If you interact with the tokens for the first time, you need to approve them. Click **Approve**, then confirm the transaction in your Ronin Wallet.
+
+6. Review the details of your liquidity contribution:
+    * The amount of LP tokens you will get in return.
+    * The amount of tokens you are contributing.
+    * The share of the pool you will receive.
+
+    Click **Confirm add liquidity**, then confirm the transaction in your Ronin Wallet.
+
+   ![Review details](../assets/katana-pool-confirm-add.png)
+
+Your transaction is now submitted to the blockchain. When it completes, Katana displays a confirmation pop-up. Close it or click **View on explorer** to see the detailed information about the transaction.
+
+![Successful liquidity addition](../assets/katana-pool-add-success.png)
+
+The **My position** panel is now updated with your latest contribution:
+
+* The amount of ERC 20 tokens you contributed.
+* The amount of LP tokens received in return.
+
+![My position](../assets/katana-pool-add-position.png)
+
+Congratulations, you are now a liquidity provider on Katana. You can now earn fees from the pool's transactions. If the pool supports farming, you can also stake your LP tokens to farm RON. For more information, see [Farm](#farm).
+
+## View your positions
+
+To see all the pools you contributed to and the fees earned, open the **Liquidity pool** page, then select **My positions**.
+
+![My positions](../assets/katana-pool-my-positions.png)
+
+Here you can see the following information:
+
+* The pools to which you contributed.
+* The APR (annual percentage rate) for each pool.
+* Your position in each pool.
+* The fees you earned from each pool.
+* Your claimable rewards from farming, if the pool supports it.
+
+To view more details, such as the amount of LP tokens and the pool's performance over time, select each pool.
+
+## Remove a liquidity pair
+
+Removing pool tokens converts your position back into underlying tokens at the current rate, proportional to your share of the pool. Accrued fees are included in the amounts you receive.
+
+1. Open the **Liquidity pool** page, then select the **My positions** tab, and then click the pool you want to withdraw from:
+
+    ![Select pool to remove](../assets/katana-pool-remove-select-pool.png)
+
+2. Select the **Remove liquidity** panel.
+
+    ![Remove liquidity panel](../assets/katana-pool-remove-liquidity-panel.png)
+
+    **Note:** If you interact with the tokens for the first time, you need to approve them. Click **Approve**, then confirm the transaction in your Ronin Wallet.
+
+3. Enter the amount of LP tokens you want to withdraw. You can also click **Max** to withdraw all your LP tokens. If everything checks out, click **Remove**. 
+
+    ![Enter amount to remove](../assets/katana-pool-remove-amount.png)
+
+4. Depending on the amount, you can see how much you're getting when removing liquidity. To confirm the withdrawal, click **Confirm remove liquidity**, then confirm the transaction in your Ronin Wallet.
+
+    ![Review details](../assets/katana-pool-confirm-remove.png)
+
+Your transaction is now submitted to the blockchain. When it completes, Katana displays a confirmation pop-up. Close it or click **View on explorer** to see the detailed information about the transaction.
+
+![Successful liquidity removal](../assets/katana-pool-remove-success.png)
+
+The **My position** panel is now updated with your latest position after removing liquidity:
+
+![My position](../assets/katana-pool-remove-position.png)
+
+You have now removed your liquidity by removing your LP tokens, and have gotten your tokens with the accrued fees, proportionate to your shares. Thank you for your service.

docs/apps/katana/guides/swap.mdx

@@ -0,0 +1,110 @@
+---
+description: Trade one token for another on Katana DEX.
+slug: /apps/katana/swap
+title: Swap
+---
+
+import roninWalletSwapSearch from '../assets/ronin-wallet-swap-search.png'
+import roninWalletSwapFrom from '../assets/ronin-wallet-swap-from.png'
+import roninWalletSwapToList from '../assets/ronin-wallet-swap-to-list.png'
+import roninWalletSwapTo from '../assets/ronin-wallet-swap-to.png'
+import roninWalletSwapDetails from '../assets/ronin-wallet-swap-details.png'
+import roninWalletSwapReviewDetails from '../assets/ronin-wallet-swap-review-details.png'
+import roninWalletSwapCompleted from '../assets/ronin-wallet-swap-completed.png'
+
+## Overview
+
+You can swap tokens on Katana to trade one token for another. Swapping is a decentralized process that doesn't require a traditional bank or other trusted third party, thanks to using smart contracts to facilitate the exchange. As an automated market maker (AMM), Katana is always ready to buy and sell any tokens immediately.
+
+### Swap on Katana web vs Ronin Wallet
+
+The swap experience differs between Katana web and Ronin Wallet:
+
+* Katana web users: Use the **Katana > Swap** page in the Ronin web app.
+* Ronin Wallet users: Use the **Wallet Swap** dApp in the Ronin Wallet mobile app or browser extension. Each swap transaction using Wallet Swap incurs a development fee of 0.5% of the transaction value.
+
+### Swap fees
+
+When swapping tokens, you incur the following fees:
+
+|Fee|Katana web|Wallet Swap|
+|---|---|---|
+|Development fee|-|0.5%|
+|Ronin treasury fee|0.05%|0.05%|
+|Liquidity provider fee|0.25%|0.25%|
+
+## Prerequisites
+
+To swap any tokens, you need to have them in your Ronin Wallet. You can acquire tokens by depositing from Ethereum using [Ronin Bridge](https://app.roninchain.com/bridge), buying through the [Purchase](https://purchase.roninchain.com) website, or receiving from other users.
+For more information, see [Acquire RON](../../../basics/acquire-ron.mdx).
+
+## Swap tokens on Katana web
+
+1. Open [Katana](https://app.roninchain.com/swap) and connect your Ronin Wallet. Katana opens on the **Swap** page by default, with the **Swap** panel in the middle.
+    ![Starting page](../assets/katana-starting.png)
+2. Choose the tokens you want to swap from and to.
+    ![Swap from](../assets/katana-swap-from.png)
+
+    You can click either of the token selection boxes to reveal the full list of supported tokens.
+    ![Swap to list](../assets/katana-swap-to-list.png)
+
+3. Enter the amount to swap by typing in either of the token selection boxes. When you type in on one of them, the other populates based on the current exchange rate between the tokens. When you are ready to swap, click **Swap**.
+
+    ![Swap to](../assets/katana-swap-to.png)
+
+    To view detailed information about the swap before proceeding, expand the exchange rate box above the **Swap** button.
+
+    ![Swap details](../assets/katana-swap-details.png)
+
+4. In the **Confirm Swap** pop-up, review the details of your swap:
+    * **Rate**: The exchange rate between the tokens.
+    * **Price impact**: estimation of the slippage to expect based on your order size and market movements. This gives you an idea of how much you can receive.
+    * **Max. slippage**: the highest percent of price movement of the transaction. Anything greater than this value results in a failed transaction.
+    * **Minimum receive**: the lowest amount of tokens you can receive based on slippage tolerance. This is the worst-case scenario. Anything less than this value results in a failed transaction.
+    * **Liquidity provider fee**: the fees allocated to liquidity providers.
+    * **Route**: the trading route taken for your order. It can be a direct "token A to token B" route, or there might be a bridge token in the middle, such as "token A through token B to token C." The direct route might not always be the cheapest.
+
+    When you're ready, click **Confirm Swap**, then confirm the transaction in your Ronin Wallet.
+    ![Review details](../assets/katana-swap-review-details.png)
+
+Your transaction is now submitted to the blockchain. When it completes, Katana displays a confirmation pop-up. Close it or click **View on explorer** to see the detailed information about the transaction.
+
+![Swap completed](../assets/katana-swap-txn-completed.png)
+
+Congratulations. You just swapped your tokens on Katana.
+
+## Swap tokens in Wallet Swap
+
+This section describes how to swap tokens using Wallet Swap in the Ronin Wallet mobile app. The process for the browser extension is similar.
+
+1. In the Ronin Wallet app, tap **DAPPS**, then search for "Swap."
+
+    <img src={roninWalletSwapSearch} width={250} />
+2. Choose the tokens you want to swap from and to.
+
+    <img src={roninWalletSwapFrom} width={250} />
+    You can click either of the token selection boxes to reveal the full list of supported tokens.
+    <img src={roninWalletSwapToList} width={250} />
+
+3. Enter the amount to swap by typing in either of the token selection boxes. When you type in on one of them, the other populates based on the current exchange rate between the tokens. When you are ready to swap, tap **Swap**.
+    <img src={roninWalletSwapTo} width={250} />
+
+    To view detailed information about the swap before proceeding, expand the exchange rate box above the Swap button.
+    <img src={roninWalletSwapDetails} width={250} />
+
+6. On the **Confirm swap** screen, review the details of your swap:
+    * **Rate**: the exchange rate between the tokens.
+    * **Price impact**: estimation of the slippage to expect based on your order size and market movements. This gives you an idea of how much you can receive.
+    * **Max. slippage**: the highest percent of price movement of the transaction. Anything greater than this value results in a failed transaction.
+    * **Minimum receive**: the lowest amount of tokens you can receive based on slippage tolerance. This is the worst-case scenario. Anything less than this value results in a failed transaction.
+    * **Liquidity provider fee**: the fees allocated to liquidity providers.
+    * **Route**: the trading route taken for your order. It can be a direct "token A to token B" route, or there might be a bridge token in the middle, such as "token A through token B to token C." Direct route might not always be the cheapest.
+
+    When you're ready, tap **Confirm Swap**, then confirm the transaction in your wallet.
+    <img src={roninWalletSwapReviewDetails} width={250} />
+
+Your transaction is now submitted to the blockchain. When it completes, Katana displays a confirmation pop-up. Close it or click **View on explorer** to see the detailed information about the transaction.
+
+<img src={roninWalletSwapCompleted} width={250} />
+
+Congratulations. You just swapped your tokens using Wallet Swap.