Address additions

src/create-an-address.md

@@ -21,8 +21,13 @@ Here we provide you with instruction on account creation:
 - [via polkadot.js browser plugin](#via-polkadotjs-browser-plugin)
 - [via polkadot.js application](#via-polkadotjs-app-ui)
 - [via SORA mobile application](#via-sora-mobile-application)
+- [via Polkaswap Telegram
+  application](#via-polkaswap-telegram-application)
 
 ::: tip
+You can also create a SORA account using [Google](/polkaswap-connect-with-google.md)
+:::
+::: tip
 
 We recommend using the SORA testnet for practice exercises. Here are the Testnet links:
 
@@ -47,29 +52,29 @@ Use a Chrome or Firefox browser.
 
 2. Open the extension and confirm that you understand the disclaimer.
 
-<center><img src="/.gitbook/assets/create-address-browser-polkadot-confirm.png" width="400"></center>
+   ![](.gitbook/assets/create-address-browser-polkadot-confirm.png)
 
 3. Create the account. You should click on the `+` button
 
-   <center><img src="/.gitbook/assets/create-address-browser-create.png" width="400"></center>
+   ![](.gitbook/assets/create-address-browser-create.png)
 
    You'll see the mnemonic. **Never share it with anyone** and don't use the same one as the screenshot (_this is just a demonstration, you will be assigned another_). **Keep this passphrase secure because it's the only way to restore your account.**
 
-   <center><img src="/.gitbook/assets/create-address-browser-mnemonic.png" width="400"></center>
+   ![](.gitbook/assets/create-address-browser-mnemonic.png)
 
 4. Click the checkbox and move on to the next step.
 
 5. Enter an account name and password then proceed
 
-   <center><img src="/.gitbook/assets/create-address-browser-name-password.png" width="400"></center>
+   ![](.gitbook/assets/create-address-browser-name-password.png)
 
    The new account is now created
 
-   <center><img src="/.gitbook/assets/create-address-browser-account-created.png" width="400"></center>
+   ![](.gitbook/assets/create-address-browser-account-created.png)
 
 6. Now you should change the address format so that it begins with `cn`. Open Settings and select Displayed Address format. It should be SORA network.
 
-   <center><img src="/.gitbook/assets/create-address-browser-change-to-sora-network.png" width="400"></center>
+   ![](.gitbook/assets/create-address-browser-change-to-sora-network.png)
 
    Great job! Now you have an address with the `cn` prefix
 
@@ -81,31 +86,31 @@ Use a Chrome or Firefox browser.
 
    If you've already installed the Polkadot browser plugin, it will request authorization to sync data. You can do it, as it will make account management easier.
 
-   ![](.gitbook/assets/create-address-app-authorize.png)
+![](.gitbook/assets/create-address-app-authorize.png)
 
 2. Open the [Accounts](https://polkadot.js.org/apps/?rpc=wss%3A%2F%2Fws.stage.sora2.soramitsu.co.jp#/accounts) page.
 
    If you allow the Polkadot browser plugin to sync, then your accounts will appear in the Polkadot.js app.
 
-   ![](.gitbook/assets/create-address-app-synced.png)
+![](.gitbook/assets/create-address-app-synced.png)
 
-   You can create a new account.
+You can create a new account.
 
 3. Click Add account:
 
-   ![](.gitbook/assets/create-address-app-add-account.png)
+![](.gitbook/assets/create-address-app-add-account.png)
 
 4. Save the mnemonic phrase, **make sure to keep it safe, and don't share it**. Confirm that you've saved the mnemonic and click Next.
 
    ![](.gitbook/assets/create-address-app-mnemonic.png)
 
 5. Enter a name and a password for the account, then click Next.
 
-   ![](.gitbook/assets/create-address-app-name-password.png)
+![](.gitbook/assets/create-address-app-name-password.png)
 
 6. After the confirmation click Save.
 
-   ![](.gitbook/assets/create-address-app-save.png)
+![](.gitbook/assets/create-address-app-save.png)
 
 Now you have two accounts. One was injected from the Polkadot browser plugin and the second one was created in the Polkadot js app.
 
@@ -141,7 +146,7 @@ When you install the application you'll be able to create an account.
 
    ::: tip
 
-   The passphrase is the only way to recover the account in case of changing the mobile phone, logging out of the application, or other emergency cases.
+   Your passphrase is the only way to recover the account in case you change/lose your mobile phone, log out of the application, or other emergency cases.
 
    :::
 
@@ -157,7 +162,48 @@ When you install the application you'll be able to create an account.
 
    ![](.gitbook/assets/create-address-sora-biometry-auth.png)
 
-#### Restoring account from mnemonic in different applications
+## Via Polkaswap Telegram Application
+
+You can create an account on SORA with Style and Freedom using the
+[Polkaswap Telegram app](https://t.me/polkaswap_io_bot).
+
+1. Follow the
+   [connect wallet
+   flow](/polkaswap-connect-wallet.md#polkaswap-telegram-app) until the
+   SORA account options.
+
+   ![](.gitbook/assets/connect-with-sora-tg.png)
+
+2. Pick the create account section.
+   ::: tip
+   Have a pen and paper handy to save the mnemonic phrase somewhere
+   safe. Ideally keep it offline.
+   :::
+
+   ![](.gitbook/assets/create-address-sora-tg-passphrase.png)
+
+3. After writing down your mnemonic or copying it, click next step and
+   input the phrase to confirm. (_You can also chose to skip this
+   option, the outcome is the same_)
+
+   ![](.gitbook/assets/create-address-sora-tg-confirm.png)
+
+4. Then, give your account a name and set a unique password. You can
+   also toggle the switch to allow JSON export to restore your
+   account. Fill in the information and finally click/tap create account.
+   ::: info
+   If you chose to enable JSON exports, make sure you keep your JSON file
+   safe and do not share it with anyone.
+   :::
+
+   ![](.gitbook/assets/create-address-sora-tg-details.png)
+
+5. After creating your account, you will be able to use it immediately
+   on the Polkaswap Telegram application!
+
+   ![](.gitbook/assets/create-address-sora-tg-success.png)
+
+## Restoring account from mnemonic in different applications
 
 The only way to restore the account in all applications is a mnemonic passphrase. The Polkadot.js browser plugin supports more options, however, the mobile application only supports a mnemonic passphrase. You can use a mnemonic passphrase from the mobile application in order to get access to [polkaswap.io](http://polkaswap.io) or [test.polkaswap.io](http://test.polkaswap.io) and vice-versa.
 
@@ -201,7 +247,23 @@ The process is the same for the mobile application:
 
    ![](.gitbook/assets/restore-account-biometry-auth.png)
 
-#### Converting the address format
+To restore an account using the Telegram App, the process is very
+easy.
+
+1. In the Connect with SORA Wallet section, click Import Account
+
+   ![](.gitbook/assets/connect-with-sora-tg.png)
+
+2. Input your mnemonic phrase or draag&drop/choose a JSON account file.
+
+   ![](.gitbook/assets/restore-account-tg-import.png)
+
+3. Give you account a name and password, then tap
+   import. Congratulations, you have restored your account.
+
+   ![](.gitbook/assets/restore-account-tg-rename.png)
+
+## Converting the address format
 
 As mentioned before, Substrate networks use different address prefixes for generating addresses. However, the key pair is the same. If you create an account, but get the address without the `cn` prefix, then you can convert it using the [Subscan address converter](https://sora.subscan.io/tools/ss58_transform).
 

src/polkaswap-connect-wallet.md

@@ -11,26 +11,77 @@ head:
 
 # Connect Your Wallet to Polkaswap
 
+With the constant improvements making Polkaswap more stylish and free,
+there are more ways to connect your account. In this section, we will
+cover how to connect your account to the web app and Telegram mini
+app.
+
+## Polkaswap Web App
+
 1. Go to [Polkaswap.io](https://polkaswap.io) and click on the "Connect account" button at the top of the page.
 
-![](.gitbook/assets/connect-wallet.png)
+<center><img src="/.gitbook/assets//connect-wallet.png" width="600"></center>
 
-2. You will see a list of supported wallet options to connect, including [Fearless Wallet](https://fearlesswallet.io), Polkadot.js, Subwallet, and Talisman.
+2. You will see a list of supported wallet options to connect,
+   including an account created on [Google](/polkaswap-connect-with-google.md), [Fearless Wallet](https://fearlesswallet.io),
+   Polkadot.js, Subwallet, and Talisman, as well as Wallet Connect.
 
-![](.gitbook/assets/choose-wallet-to-connect.png)
+<center><img src="/.gitbook/assets/choose-wallet-to-connect.png" width="600"></center>
 
 3. Select the wallet extension installed on your browser. For example, if you are using Fearless Wallet, click on the Fearless Wallet option.
-4. A pop-up window will appear from your selected wallet extension, asking you to confirm the connection to Polkaswap. Click "Confirm" to proceed.
-5. After the connection has been established, you will see a list of your available accounts displayed on the Polkaswap page. Choose the account you want to use and click on it.
+4. A pop-up window will appear from your selected wallet extension,
+   asking you to confirm the connection to Polkaswap. Click "Confirm"
+   to proceed.
+5. If you chose Wallet Connect, a popup with a QR code will appear for
+   you to scan with your mobile wallet, otherwise you can copy the link.
+
+<center><img src="/.gitbook/assets/use-wallet-connect.png" width="600"></center>
+
+6. After the connection has been established, you will see a list of your available accounts displayed on the Polkaswap page. Choose the account you want to use and click on it.
+
+<center><img src="/.gitbook/assets/select-an-account.png" width="600"></center>
+
+7. Once the connection is complete, you will be able to see your
+   account balance and manage your funds on Polkaswap.
+
+## Polkaswap Telegram App
+
+1. Access the [Polkaswap Telegram app](https://t.me/polkaswap_io_bot) and
+   launch the bot.
+
+<center><img src="/.gitbook/assets/connect-wallet-tg.png" width="600"></center>
+
+2. Click on the wallet icon on the top right or the connect account
+   button on the main screen.
+
+<center><img src="/.gitbook/assets/connect-account-tg.png" width="600"></center>
+
+3. You can either connect a SORA account or use Wallet Connect. If you
+   chose to connect a SORA account, you have the option to create a
+   new account directly in the interface or import an existing account
+   with your mnemonic phrase or a json file.
+
+::: info
+Follow the [Create an Address
+flow](/create-an-address.md#via-polkaswap-telegram-application) if you
+do not have a SORA address yet, or [restore an existing address](create-an-address.md#restoring-account-from-mnemonic-in-different-applications) if you already have one.
+:::
+
+<center><img src="/.gitbook/assets/connect-with-sora-tg.png" width="600"></center>
+
+<center><img src="/.gitbook/assets/import-sora-tg.png" width="600"></center>
+
+4. If you choose to use Wallet Connect, the interface is very similar
+   to the web app, where you can scan the QR or copy the code for your
+   wallet.
+
+<center><img src="/.gitbook/assets/connect-with-wc-tg.png" width="600"></center>
 
-![](.gitbook/assets/select-an-account.png)
+Congratulations, you have successfully connected your wallet! Now you can stake, provide liquidity, trade, and much more with style and freedom on Polkaswap!
 
-6. Once the connection is complete, you will be able to see your account balance and manage your funds on Polkaswap.
-   Congratulations, you have successfully connected your wallet! Now you can stake, provide liquidity, trade, and much more with style and freedom on Polkaswap!
-   Remember to always do your own research before making any financial
-   decisions.
+_Remember to always do your own research before making any financial decisions._
 
-   ## Learn More
+## Learn More
 
 - [Create an Address](/create-an-address.md)
 - [Account Security](/account-security.md)

src/polkaswap-connect-with-google.md

@@ -12,7 +12,8 @@ head:
 # Connect With Google
 
 Connecting to [Polkaswap.io](https://polkaswap.io/#/wallet) has never been easier. Use a Google login to access your SORA account with style and freedom.
-This feature would be of most interest to people who are new at DeFi and blockchain accounts.
+This feature would be of most interest to people who are new at DeFi
+and blockchain accounts.
 ::: warning
 Never share your personal account information with anyone.
 :::
@@ -46,7 +47,10 @@ Never share your personal account information with anyone.
 7. Give your account a name and password, then confirm the password. You can also export a JSON file at this point. **If you toggle the JSON file for the account restoration option, Polkaswap will download your account’s JSON file to your computer or device.**
 
 ::: info
-You can use the JSON file to import an account on Polkaswap or another wallet.
+You can use the JSON file to import an account on [Polkaswap.io](https://polkaswap.io/#/wallet) or the
+[Polkaswap Telegram app](https://t.me/polkaswap_io_bot). For more
+information visit the [Connect Wallet
+page](/polkaswap-connect-wallet.md) page.
 :::
 
 ![](.gitbook/assets/google-login-8.png)
@@ -82,6 +86,12 @@ To access Polkaswap using this account, click on the account’s name, then inpu
 
 ![](.gitbook/assets/google-importing-5.png)
 
+::: info
+You can connect your Google account to the [Polkaswap Telegram
+app](https://t.me/polkaswap_io_bot). For more information visit the
+[Connect Wallet page](/polkaswap-connect-wallet.md).
+:::
+
 ## Making Transactions with a Google Account
 
 After your Google account has been selected as the active account, your balances will be available in the Wallet view.