Skip to content

Commit

Permalink
formatting for all user guides now consistent. please verify
Browse files Browse the repository at this point in the history
  • Loading branch information
gbaci committed Jan 16, 2025
1 parent 639cc02 commit d2bb5e6
Show file tree
Hide file tree
Showing 16 changed files with 184 additions and 166 deletions.
6 changes: 3 additions & 3 deletions docs/01_quick_start/03_wallets/01_mobile.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ To get your Hydration account ready to go on mobile, follow the steps below.

*Although this guide focuses on Nova Wallet, the process is generally similar to that of other mobile wallets like SubWallet. Click [here](https://wiki.polkadot.network/docs/wallets-index) to check out other mobile wallets available on Polkadot.*

## Setting Up Nova Wallet
## 00 Setting Up Nova Wallet

Begin by downloading the Nova Wallet application from the official website, accessible [here](https://novawallet.io/), or on the App Store.

Expand All @@ -19,7 +19,7 @@ Begin by downloading the Nova Wallet application from the official website, acce
width="600px" />
</div>

## Creating Your Account
## 01 Creating Your Account

1. To create a new wallet, launch the Nova Wallet app and click the **Create A New Wallet** button.
2. Enter a name for your wallet to proceed.
Expand All @@ -32,7 +32,7 @@ Do not share your mnemonic phrase with anyone. It’s advisable to not take scre
4. For added security, you will be asked to re-enter the mnemonic phrase in the correct sequence.
5. Set up your PIN which will be used for accessing the app.

## Using Nova Wallet
## 03 Using Nova Wallet

To access your Hydration account, locate the Hydration section within the app.

Expand Down
6 changes: 3 additions & 3 deletions docs/01_quick_start/03_wallets/02_desktop.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,10 +10,10 @@ There are multiple options for creating a Hydration account on a desktop, includ

This guide will walk you through setting up your account using the Talisman wallet.

## Setting Up Talisman
## 00 Setting Up Talisman
To get started, download the **Talisman extension** from the [official website](https://www.talisman.xyz/). The Talisman extension supports most modern browsers.

## Creating Your Account
## 01 Creating Your Account
1. Once you’ve downloaded and installed the extension, launch it and click on the **Add Account** button.
2. Select **Polkadot** as the account, and input the account name of your choice. Then click **Create**.

Expand All @@ -30,7 +30,7 @@ Do not share your mnemonic phrase with anyone. It’s advisable to not take scre
5. Verify your phrase by inputting it in the correct order.
6. To copy your Hydration address, click on the **Copy** button. Scroll down and look for Hydration, then click the copy icon to copy the address

## Using Talisman
## 02 Using Talisman
<div style={{textAlign: 'center'}}>
<img alt="Nova Wallet Landing Page" src={useBaseUrl('/howto_wallet_desktop/talisman_copy_address.gif')}
width="600px" />
Expand Down
16 changes: 8 additions & 8 deletions docs/01_quick_start/03_wallets/03_ledger.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,14 +11,14 @@ Securing your HDX tokens in cold storage while signing transactions on the Hydra

---

## Setting Up Ledger
## 00 Setting Up Ledger

### Prepare Your Ledger Device
### 00 Prepare Your Ledger Device

1. Download and install **Ledger Live** on your computer. You can learn more about how to get started with Ledger Live [here](https://support.ledger.com/article/4404389503889-zd?redirect=false).
2. Open Ledger Live, connect your Ledger device to **My Ledger**, and ensure your device is running the latest firmware version. If not, **update the firmware** of your Ledger Nano S / Nano S Plus / Nano X.

### Install the Polkadot App
### 01 Install the Polkadot App

1. Open **Ledger Live** and navigate to the **My Ledger** tab.
2. **Connect** and **unlock** your Ledger device.
Expand All @@ -30,7 +30,7 @@ Securing your HDX tokens in cold storage while signing transactions on the Hydra
width="700px" />
</div>

### Create Your Account
### 02 Create Your Account

1. Open **Ledger Live** and navigate to the **Accounts** tab.
2. Click **Add Account**.
Expand All @@ -49,7 +49,7 @@ Securing your HDX tokens in cold storage while signing transactions on the Hydra

---

## Using Ledger with Talisman
## 01 Using Ledger with Talisman

1. Open the **Talisman Wallet extension**. Click the three horizontal dots at the bottom-right, and select **Add Account**.

Expand Down Expand Up @@ -92,7 +92,7 @@ Your Ledger account(s) should now appear in your Talisman Wallet Accounts tab. Y

---

## Using Ledger with SubWallet
## 02 Using Ledger with SubWallet

1. Open the **SubWallet extension** and click on the **Account Name** to open the account selection tab.

Expand Down Expand Up @@ -128,7 +128,7 @@ Your Ledger account(s) should now appear in your SubWallet Accounts tab. You can

---

## Signing Transactions with Ledger
## 03 Signing Transactions with Ledger

1. Ensure your Ledger device is connected to the wallet you wish to use (Talisman or SubWallet).
2. Go to [app.hydration.net](https://app.hydration.net/).
Expand All @@ -139,7 +139,7 @@ Congratulations! The transaction is now complete. If you encounter any issues, e

---

## Need Help?
## 04 Need Help?

If you are having any issues with the Polkadot Ledger App, check out the following resources:
1. Polkadot Forum post on [New Polkadot Ledger App](https://forum.polkadot.network/t/new-polkadot-ledger-app/8817).
Expand Down
15 changes: 8 additions & 7 deletions docs/01_quick_start/03_wallets/04_metamask.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,23 +17,24 @@ The following guides will walk you through using an EVM wallet on Hydration.

## How to Connect an EVM Wallet to Hydration (MetaMask)

1. Click the **Connect** button at the top-right of the [Hydration Portal](https://app.hydration.net/).
### 00 Connect
Click the **Connect** button at the top-right of the [Hydration Portal](https://app.hydration.net/).

<div style={{textAlign: 'center'}}>
<img alt="Hydration UI" src={useBaseUrl('/howto_wallet_evm/evm_connectwallet.jpg')}
width="700px" />
</div>


2. Select **EVM** and choose your preferred wallet. For this guide we will choose **MetaMask**. There is also the option of **Talisman**, **WalletConnect**, and **SubWallet**. More wallets will be added as becomes necessary.
### 01 - Choose EVM
Select **EVM** and choose your preferred wallet. For this guide we will choose **MetaMask**. There is also the option of **Talisman**, **WalletConnect**, and **SubWallet**. More wallets will be added as becomes necessary.

<div style={{textAlign: 'center'}}>
<img alt="Hydration UI" src={useBaseUrl('/howto_wallet_evm/evm_wallets.jpg')}
width="500px" />
</div>


3. Sign-in to **MetaMask** and select the account you would like to connect to Hydration.
### 02 Sign-in
Sign-in to **MetaMask** and select the account you would like to connect to Hydration.

<div style={{textAlign: 'center'}}>
<img alt="Hydration UI" src={useBaseUrl('/howto_wallet_evm/metamask_accounts.jpg')}
Expand All @@ -45,8 +46,8 @@ The following guides will walk you through using an EVM wallet on Hydration.
width="500px" />
</div>


4. Click **Confirm** and accept changing network to Hydration.
### 03 Confirm
Click **Confirm** and accept changing network to Hydration.

<div style={{textAlign: 'center'}}>
<img alt="Hydration UI" src={useBaseUrl('/howto_wallet_evm/evm_accountadded.jpg')}
Expand Down
34 changes: 17 additions & 17 deletions docs/01_quick_start/03_wallets/05_vault.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,41 +8,41 @@ import useBaseUrl from '@docusaurus/useBaseUrl';

[Polkadot Vault](https://www.parity.io/technologies/signer/) is a mobile app which turns your iOS or Android device into a dedicated hardware wallet for Polkadot, Kusama, and any other Substrate-based chain. It allows you to keep your private keys offline while still being able to conveniently sign transactions in an air-gapped way using QR codes.

## Set Up Parity Signer
### Before You Start: Stay Safe
#### Start clean
## 01 Set Up Parity Signer
### 00 Before You Start: Stay Safe
#### 00 Start clean
Before installing Parity Signer, make sure that your phone is in a clean state. If it has been used, perform a factory reset and do not install any other apps besides Parity Signer.

#### Don’t Insert Sim
#### 01 Don’t Insert Sim
If possible, don’t turn on WiFi or use a secure WiFi connection, preferably with no other connected devices and a reputable VPN provider to connect, update the device, and install the Parity signer app.

#### Use Strong Passwords
#### 02 Use Strong Passwords
For robust security, use long passwords for the device and the accounts you need to create to use it.

#### Setup New Account
#### 03 Setup New Account
Don’t use your old google ID or apple ID, create a new one specifically for this use which will be used only to download updates and parity signer. In case of Android device it’s better to not use WiFi or google account at all. We recommend using some sort of OS that encrypts your data like [Lineage O.S.](https://lineageos.org) If an email is required, create a new one. Alternatively, you can create new apple id and email on iOS.

#### No Biometrics
#### 04 No Biometrics
Avoid fingerprint scanners, face ID, or shot numeric codes as they are exploitable. Use a strong password instead.

#### Disable All Signal-receiving Features
#### 05 Disable All Signal-receiving Features
Use airplane mode and make sure to disable all of these features manually. If you are on an iOS device, turn it off and ask to auto-join networks and hotspots in the WiFi settings. Including:

* Location services
* WiFi (if required to upgrade or setup, disable right after the update)
* Bluetooth

#### Logout From All Accounts
#### 06 Logout From All Accounts
Log out from App stores, iCloud, and any other accounts you’ve joined.

#### Updating Your Device
#### 07 Updating Your Device
If you are using WiFi to update your device, remember to disable it right after the update and use it only in a secure environment, preferably through a secure and encrypted VPN channel. After the update is complete, forget the WiFi network to make sure you don't automatically rejoin.

### Install Parity Signer
### 01 Install Parity Signer
Install Parity Signer from the official app store for your device (iOS / Android).
Make sure that the application you are downloading has been published by Parity Technologies.

### Create a New Account
### 02 Create a New Account
To create a new account, follow the steps below.

#### 01 Add Seed
Expand Down Expand Up @@ -72,7 +72,7 @@ To protect your seed phrase, consider the following tips:
* Never give your seed phrase to anybody, including support staff.
:::

### Connect to Polkadot.js/apps
### 03 Connect to Polkadot.js/apps
Optionally, you can add your Parity Signer account into the Polkadot.js browser extension which will allow you to view your balances on the [Polkadot.js/apps accounts page](https://polkadot.js.org/apps/#/accounts) and to sign transactions more easily.

#### On Polkadot.js/apps
Expand All @@ -88,7 +88,7 @@ To add your account, open the Polkadot.js browser extension, click on `+` and se
* Select your desired account or sub-account;
* You will see a QR code which you need to scan with your device camera.

### Add Hydration Chain
### 04 Add Hydration Chain
To use Parity Signer, you first need to add a new chain to Parity Signer. If you want to use Parity only for Polkadot or Kusama, you can skip this step and proceed with updating metadata. To add a new chain, you need to scan a QR code with base information about the chain.

#### 01 Get Chain Specs
Expand All @@ -101,12 +101,12 @@ On your Desktop, navigate to https://nova-wallet.github.io/metadata-portal/ and
#### 02 Add Specs
On your Parity Signer, click `Scanner`, scan the QR code and click `Add new chain`.

## Use Parity Signer
## 02 Use Parity Signer
:::warning
Always make sure you are scanning a QR code signed by a trusted verifier.
:::

### Sign a Transaction
### 01 Sign a Transaction
To sign a transaction from your parity signer, we recommended adding it to polkadot.js extension for ease of use. Until more chains can work with Parity Signer directly, it will be the most convenient way to use it inside applications on your desktop.

When signing a transaction using your Parity Signer, Polkadot.js/apps will display a QR code.
Expand All @@ -123,7 +123,7 @@ Scan the QR code using Parity Signer and click on `Unlock key and sign`.

Your Parity Signer will now display a QR code. To complete signing the transaction, switch back to Polkadot.js/apps and click on `Scan signature via camera`.

### Update Metadata
### 02 Update Metadata
To use the Parity Signer, you require the latest metadata for decoding transactions in the Parity Signer. You can acquire the metadata by scanning a multi-part QR code containing this data, allowing the Parity Signer to decode the actual transaction and display it correctly before you sign. This step is similar to updating your ledger application.

#### 01 Get Metadata
Expand Down
8 changes: 4 additions & 4 deletions docs/01_quick_start/04_deposit/02_within_polkadot.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,21 +16,21 @@ Currently, the following tokens are supported by Hydration for cross-chain trans
* ETH (from Acala, bridged via Wormhole)
* HDX

## 00 Prerequisites
## 00 - Prerequisites
Before you continue, please make sure you have sufficient amount of tokens on the destination chain for fees (ACA or DOT).

## 01 Navigate to Cross-chain Transfers
## 01 - Navigate to Cross-chain Transfers
[https://app.hydration.net/#/cross-chain](https://app.hydration.net/#/cross-chain)

<div style={{textAlign: 'center'}}>
<img alt="metadata" src={useBaseUrl('/howto_xcm/xcm_screen.jpg')} width="500px" />
</div>


## 02 Connect Your Account
## 02 - Connect Your Account
Click on `Connect wallet` and connect to your preferred Polkadot wallet. After that, select your account.

## 03 Cross-chain Transfer
## 03 - Cross-chain Transfer
* Select the source chain and the destination chain;
* Select the asset you intend to transfer and enter the amount;
* Enter the destination address. It should automatically populate with your address on that chain, but you can also change it to another address;
Expand Down
8 changes: 4 additions & 4 deletions docs/01_quick_start/05_trade/02_dca.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,23 +12,23 @@ Before proceeding, we encourage you to visit our [DCA product page](/products/tr
<img src={useBaseUrl('/howto_dca/dca.jpg')} />
</div>

### Step 1: Navigate to Hydration DCA Page
### 01 Navigate to Hydration DCA Page

https://app.hydration.net/dca

### Step 2: Connect to Your Account
### 02 Connect to Your Account

Connect your wallet to Hydration by clicking **`Connect Account` (1 in image above).**

### Step 3: Set up DCA Order
### 03 Set up DCA Order
* Select the asset you will use to pay for the swap; Enter the order amount for each DCA trade, and the total order size **(2)**;
* Select the time interval for each DCA swap **(3)**;
* Select the asset you would like to receive from the swap **(4)**;
* For advanced users who would like to set up orders at specific block intervals, you can toggle the switch **Advanced Settings (5**) to set this up;
* If you would like to adjust your slippage preferences, you can do so by clicking on the **Settings Icon (6)**;
* To complete the DCA order, click on **Schedule DCA trades** **(7)** and sign the transaction using your wallet app.

### Step 4: View your DCA Order
### 04 View your DCA Order
* After submitting it, your DCA order will appear under **DCA Orders**;
* To see the details, click the **Dropdown Arrow (8)**;
* You can cancel your DCA order for the remaining amount by clicking on **Terminate (9)**.
Expand Down
6 changes: 3 additions & 3 deletions docs/03_guides/01_wallets/01_mobile.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ To get your Hydration account ready to go on mobile, follow the steps below.

*Although this guide focuses on Nova Wallet, the process is generally similar to that of other mobile wallets like SubWallet. Click [here](https://wiki.polkadot.network/docs/wallets-index) to check out other mobile wallets available on Polkadot.*

## Setting Up Nova Wallet
## 00 Setting Up Nova Wallet

Begin by downloading the Nova Wallet application from the official website, accessible [here](https://novawallet.io/), or on the App Store.

Expand All @@ -19,7 +19,7 @@ Begin by downloading the Nova Wallet application from the official website, acce
width="600px" />
</div>

## Creating Your Account
## 01 Creating Your Account

1. To create a new wallet, launch the Nova Wallet app and click the **Create A New Wallet** button.
2. Enter a name for your wallet to proceed.
Expand All @@ -32,7 +32,7 @@ Do not share your mnemonic phrase with anyone. It’s advisable to not take scre
4. For added security, you will be asked to re-enter the mnemonic phrase in the correct sequence.
5. Set up your PIN which will be used for accessing the app.

## Using Nova Wallet
## 03 Using Nova Wallet

To access your Hydration account, locate the Hydration section within the app.

Expand Down
6 changes: 3 additions & 3 deletions docs/03_guides/01_wallets/02_desktop.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,10 +10,10 @@ There are multiple options for creating a Hydration account on a desktop, includ

This guide will walk you through setting up your account using the Talisman wallet.

## Setting Up Talisman
## 00 Setting Up Talisman
To get started, download the **Talisman extension** from the [official website](https://www.talisman.xyz/). The Talisman extension supports most modern browsers.

## Creating Your Account
## 01 Creating Your Account
1. Once you’ve downloaded and installed the extension, launch it and click on the **Add Account** button.
2. Select **Polkadot** as the account, and input the account name of your choice. Then click **Create**.

Expand All @@ -30,7 +30,7 @@ Do not share your mnemonic phrase with anyone. It’s advisable to not take scre
5. Verify your phrase by inputting it in the correct order.
6. To copy your Hydration address, click on the **Copy** button. Scroll down and look for Hydration, then click the copy icon to copy the address

## Using Talisman
## 02 Using Talisman
<div style={{textAlign: 'center'}}>
<img alt="Nova Wallet Landing Page" src={useBaseUrl('/howto_wallet_desktop/talisman_copy_address.gif')}
width="600px" />
Expand Down
10 changes: 5 additions & 5 deletions docs/03_guides/01_wallets/03_ledger.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ Securing your HDX tokens in cold storage while signing transactions on the Hydra

---

## Setting Up Ledger
## 00 Setting Up Ledger

### Prepare Your Ledger Device

Expand Down Expand Up @@ -49,7 +49,7 @@ Securing your HDX tokens in cold storage while signing transactions on the Hydra

---

## Using Ledger with Talisman
## 01 Using Ledger with Talisman

1. Open the **Talisman Wallet extension**. Click the three horizontal dots at the bottom-right, and select **Add Account**.

Expand Down Expand Up @@ -92,7 +92,7 @@ Your Ledger account(s) should now appear in your Talisman Wallet Accounts tab. Y

---

## Using Ledger with SubWallet
## 02 Using Ledger with SubWallet

1. Open the **SubWallet extension** and click on the **Account Name** to open the account selection tab.

Expand Down Expand Up @@ -128,7 +128,7 @@ Your Ledger account(s) should now appear in your SubWallet Accounts tab. You can

---

## Signing Transactions with Ledger
## 03 Signing Transactions with Ledger

1. Ensure your Ledger device is connected to the wallet you wish to use (Talisman or SubWallet).
2. Go to [app.hydration.net](https://app.hydration.net/).
Expand All @@ -139,7 +139,7 @@ Congratulations! The transaction is now complete. If you encounter any issues, e

---

## Need Help?
## 04 Need Help?

If you are having any issues with the Polkadot Ledger App, check out the following resources:
1. Polkadot Forum post on [New Polkadot Ledger App](https://forum.polkadot.network/t/new-polkadot-ledger-app/8817).
Expand Down
Loading

0 comments on commit d2bb5e6

Please sign in to comment.