docs(UG): update user guides + additions (#4389)

ComposableFi · Dec 25, 2023 · b8417ac · b8417ac
2 parents c6a06c2 + 45b2937
commit b8417ac
Show file tree

Hide file tree

Showing 24 changed files with 65 additions and 159 deletions.
diff --git a/docs/docs/user-guides/centauri-guide.md b/docs/docs/user-guides/centauri-guide.md
diff --git a/docs/docs/user-guides/centauri-transfers.md b/docs/docs/user-guides/centauri-transfers.md
diff --git a/docs/docs/user-guides/dot-lp-guide.md b/docs/docs/user-guides/dot-lp-guide.md
@@ -0,0 +1,40 @@
+# How to LP & stake DOT on Pablo via Trustless Zone
+
+The [IBC](../technology/composable-ibc.md) DOT-KSM connection serves as the first transfer protocol between Kusama (KSM) and Polkadot (DOT), unlocks the potential for a seamless flow of liquidity between parachains on both networks. Token transfers are a prime example of this, enabling increased liquidity across protocols on both chains. It is important to note that IBC powers functionality beyond token transfers and unlocks composability between Polkadot and Kusama. One could possibly send XCM messages using IBC as a transport layer. This would enable XCM execution on Kusama or a Kusama parachain sent from Polkadot or a Polkadot parachain. 
+
+This guide outlines the steps involved in transferring DOT from Polkadot to Picasso using XCM and IBC to provide liquidity on [Pablo](../technology/pablo-overview.md).
+
+There are two steps required to complete the process:
+
+1. Multihop DOT from Polkadot to [Picasso](../parachains/picasso-parachain-overview.md)
+2. Provide liquidity & stake using DOT paired with various pools on Pablo
+
+
+## Multihop DOT from Polkadot to Picasso
+
+Head to [app.trustless.zone](https://app.trustless.zone/) and select `Polkadot` and `Picasso` as the source and destination chains respectively. Enter the amount you wish to transfer, press 'Send' and sign the transaction.
+
+![trustless-1](./images-dot-lp-guide/ibc-dot-picasso.png)
+## Provide liquidity to DOT pairs on Pablo
+
+On [app.pablo.finance](https://app.pablo.finance/), connect your wallet and navigate to the "Provide liquidity" page.
+
+Choose one of the available pools (in this guide, we will use PICA/DOT).
+
+![pablo-1](./images-dot-lp-guide/pablo-lp-1.png)
+
+Enter the PICA/DOT pool page and select "Add Liquidity". Enter the amount you wish to deposit and select "Add Liquidity" once more. 
+
+A pop-up will appear to confirm the transaction by clicking "Confirm" and then sign the transaction. 
+
+A "Transaction success" notification will appear and you can click the notification to view the transaction on Subscan.
+
+
+![pablo-2](./images-dot-lp-guide/pablo-lp-2.png)
+
+Head back to the pool overview page and click "Stake". Enter the amount of LP tokens you wish to stake and click "Stake PICA-DOT" to start earning rewards on your LP position. You will be asked to sign the transaction with your password.
+
+![pablo_3](./images-dot-lp-guide/stake-3.png)
+
+
+Congratulations! You have successfully staked liquidity on Pablo.
diff --git a/docs/docs/user-guides/how-to-provide-liquidity.md b/docs/docs/user-guides/how-to-provide-liquidity.md
@@ -3,19 +3,6 @@
 Providing liquidity on a decentralized exchange (DEX) like Pablo can be a way to earn passive income by providing assets to liquidity pools.
 Here is a guide on how to provide liquidity on the Pablo DEX. 
 
-:::info
-
-The following pools are live on [Pablo](https://app.pablo.finance/provide-liquidity/) and currently offering LP staking rewards:
-
-- KSM/USDT
-- PICA/USDT
-- PICA/KSM
-- PICA/DOT
-- DOT/USDT
-- KSM/DOT
-
-:::
-
 The Picasso Council has proposed a fee of 0.3% for the inaugural pools. Users who provide liquidity to these pools can earn a share of the fees that the pools generate. The fees for swapping, buying or selling tokens are calculated as a percentage of the swap size and are distributed among liquidity providers based on their share of the pool.
 
 To learn how to swap tokens on Pablo, you can follow a step-by-step tutorial provided in this guide.

diff --git a/docs/docs/user-guides/images-centauri-chain/stake-1.png b/docs/docs/user-guides/images-centauri-chain/stake-1.png
diff --git a/docs/docs/user-guides/images-centauri-chain/stake-2.png b/docs/docs/user-guides/images-centauri-chain/stake-2.png
diff --git a/docs/docs/user-guides/images-centauri-guide/centauri-guide-1.png b/docs/docs/user-guides/images-centauri-guide/centauri-guide-1.png
diff --git a/docs/docs/user-guides/images-centauri-guide/centauri-guide-10.png b/docs/docs/user-guides/images-centauri-guide/centauri-guide-10.png
diff --git a/docs/docs/user-guides/images-centauri-guide/centauri-guide-2.png b/docs/docs/user-guides/images-centauri-guide/centauri-guide-2.png
diff --git a/docs/docs/user-guides/images-centauri-guide/centauri-guide-3.png b/docs/docs/user-guides/images-centauri-guide/centauri-guide-3.png
diff --git a/docs/docs/user-guides/images-centauri-guide/centauri-guide-4.png b/docs/docs/user-guides/images-centauri-guide/centauri-guide-4.png
diff --git a/docs/docs/user-guides/images-centauri-guide/centauri-guide-5.png b/docs/docs/user-guides/images-centauri-guide/centauri-guide-5.png
diff --git a/docs/docs/user-guides/images-centauri-guide/centauri-guide-6.png b/docs/docs/user-guides/images-centauri-guide/centauri-guide-6.png
diff --git a/docs/docs/user-guides/images-centauri-guide/centauri-guide-7.png b/docs/docs/user-guides/images-centauri-guide/centauri-guide-7.png
diff --git a/docs/docs/user-guides/images-centauri-guide/centauri-guide-8.png b/docs/docs/user-guides/images-centauri-guide/centauri-guide-8.png
diff --git a/docs/docs/user-guides/images-centauri-guide/centauri-guide-9.png b/docs/docs/user-guides/images-centauri-guide/centauri-guide-9.png
diff --git a/docs/docs/user-guides/images-dot-lp-guide/ibc-dot-picasso.png b/docs/docs/user-guides/images-dot-lp-guide/ibc-dot-picasso.png
diff --git a/...ides/images-centauri-guide/pablo-lp-1.png → ...guides/images-dot-lp-guide/pablo-lp-1.png b/...ides/images-centauri-guide/pablo-lp-1.png → ...guides/images-dot-lp-guide/pablo-lp-1.png
diff --git a/...ides/images-centauri-guide/pablo-lp-2.png → ...guides/images-dot-lp-guide/pablo-lp-2.png b/...ides/images-centauri-guide/pablo-lp-2.png → ...guides/images-dot-lp-guide/pablo-lp-2.png
diff --git a/...-guides/images-centauri-guide/stake-3.png → ...er-guides/images-dot-lp-guide/stake-3.png b/...-guides/images-centauri-guide/stake-3.png → ...er-guides/images-dot-lp-guide/stake-3.png
diff --git a/docs/docs/user-guides/images-trustless-transfer/trustless-transfer.png b/docs/docs/user-guides/images-trustless-transfer/trustless-transfer.png
diff --git a/docs/docs/user-guides/keplr-guide.md b/docs/docs/user-guides/keplr-guide.md
@@ -28,6 +28,10 @@ After verifying your recovery phrase, you will come across a drop down menu to a
 
 In the search bar type “Composable”, choose the Composable chain and click “Save".
 
+:::tip 
+If you don't see the Composable Cosmos chain in the dropdown, head to Keplr settings. In the general section, look for the option to manage non-native chains. Here, you can add the Composable chain.
+:::
+
 ![keplr-3](./images-keplr-guide/images-keplr-5.png)
 
 Congratulations! You have now integrated your Keplr account with Composable cosmos.

diff --git a/docs/docs/user-guides/trustless-transfers.md b/docs/docs/user-guides/trustless-transfers.md
@@ -0,0 +1,13 @@
+# How to transfer assets between Picasso & Osmosis
+
+Composable implemented the first IBC implementation that operates outside of the Cosmos ecosystem. This guide will demonstrate how to transfer assets between Picasso and Osmosis. 
+
+In this guide, PICA will be transferred between Picasso and Osmosis however, you can also transfer DOT from Polkadot to Osmosis in one click.
+
+Head to https://app.trustless.zone/ and connect both, your Polkadot and Cosmos wallets.
+
+![transfer](./images-trustless-transfer/trustless-transfer.png)
+
+Enter the amount of PICA and click 'Transfer'. A pop-up asking you to sign your transaction will appear, approve the transaction.
+
+Transactions can take up to 2-5 minutes to complete, you can view the progress on https://explorer.trustless.zone/ 
diff --git a/docs/sidebars.js b/docs/sidebars.js
@@ -58,8 +58,8 @@
              "user-guides/how-to-provide-liquidity",
              "user-guides/how-to-trade-pica-on-pablo",
              "user-guides/composable-cosmos-staking",
-             "user-guides/centauri-guide",
-             "user-guides/centauri-transfers",
+             "user-guides/dot-lp-guide",
+             "user-guides/trustless-transfers",
            ],
          },
          {