Skip to content

Commit

Permalink
Merge branch 'main' into staking
Browse files Browse the repository at this point in the history
  • Loading branch information
vgantchev committed Sep 13, 2023
2 parents 4d5b23c + 3b6e0c2 commit 03aacf9
Show file tree
Hide file tree
Showing 6 changed files with 27 additions and 35 deletions.
15 changes: 11 additions & 4 deletions docs/howto_trade.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,20 +10,20 @@ This page provides a **step-by-step guide** which will **help you execute your f
The HydraDX Omnipool is a next-gen AMM which unlocks unparalleled efficiencies, you can find out more in our [product documentation](/).

<div style={{textAlign: 'center'}}>
<img alt="metadata" src={useBaseUrl('/howto_trade/trade_screen.jpg')} />
<img alt="metadata" src={useBaseUrl('/howto_trade/trade_screen_st.jpg')} />
</div>

## 00 Transport tokens
If you would like to execute a trade using a non-native asset (e.g. DOT or DAI), you first need to get these assets to the HydraDX chain. This step does not apply to HDX.

There are two different mechanisms to transport non-native assets:
* [Cross-chain transfer](https://app.hydradx.io/#/cross-chain) - use this tool to transfer assets from other Polkadot parachains, or from Polkadot itself. Step-by-step documentation [here](howto_xcm);
* [Cross-chain transfer](https://app.hydradx.io/cross-chain) - use this tool to transfer assets from other Polkadot parachains, or from Polkadot itself. Step-by-step documentation [here](howto_xcm);
* [Ethereum bridge](https://www.portalbridge.com/#/transfer) - for bridging assets from the Ethereum ecosystem. Step-by-step documentation [here](/howto_bridge).

These solutions can also be used to transport tokens outside of the HydraDX network.

## 01 Enter Omnipool
[https://app.hydradx.io/#/trade](https://app.hydradx.io/#/trade)
[https://app.hydradx.io/#/trade](https://app.hydradx.io/trade)

## 02 Connect Your Account
Click on `Connect wallet` **(1 in image above)** and connect to your preferred Polkadot wallet. After that, select your account.
Expand All @@ -35,6 +35,13 @@ The HydraDX Trade UI allows you to intuitively execute a trade:
* Enter the amount of tokens for the trade **(3)**.
You can enter the amount of tokens you would like to pay with (e.g. 5000 DAI), but you can also enter the amount of tokens you would like to receive (e.g. 1000 HDX);
* If you would like to adjust your slippage preferences, you can do so in `Settings` **(4)**;
* To complete the trade, click on `Swap` **(5)** and sign the transaction using your wallet.
* To complete the trade with instant execution (pre-selected) **(5)**, click on `Swap` **(7)** and sign the transaction using your wallet. Otherwise, follow the additional steps below.

## 04 Execute a Split Trade
If your trade is large enough so that price impact would be > 0.15%, the UI will allow you to select `Split trade` **(6)** - breaking your trade into multiple smaller trades executed over < 3 hours and therefore reducing your price impact.

* Select the pair of tokens and amounts as in **03 Execute a Trade** above;
* Select `Split trade` **(6)**;
* To schedule your Split trade execution, click on `Place trades` **(7)** and sign the transaction using your wallet.

Stay hydrated, not liquidated.
47 changes: 16 additions & 31 deletions docs/participate_in_referenda.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,51 +5,36 @@ title: Participate in Referenda

import useBaseUrl from '@docusaurus/useBaseUrl';

This post provides a step-by-step guide on how to participate in referenda - voting and proposing. There are two alternative tools which you can use for this purpose - [Commonwealth.im](#cw) or [Polkadot/apps](#polkajs).
This post provides a step-by-step guide on how to participate in referenda - voting and proposing. There are two alternative tools which you can use for this purpose - [Subsquare](#sub) or [Polkadot/apps](#polkajs).

Before you decide to participate, we strongly encourage you to read through the [knowledge article](/democracy_referenda) in the Learn / Democracy section. There you will find some important details on the mechanics behind referenda.

:::caution
The HydraDX democracy module will be launched on or after **15 September 2021**. Please do not attempt any of the shown actions before that date.
:::

## Using Commonwealth.im {#cw}
### Vote in a Referendum {#cw-vote}
You can see all referenda which are open for voting by navigating to the [Referenda tab](https://commonwealth.im/hydradx/referenda) on the HydraDX Commonwealth page.

To vote on an active referendum, you need to click on it. After that, you will see a page showing all relevant details.

In the section *Cast Your Vote*, fill in the following information:
## Using Subsquare {#sub}
### Vote in a Referendum {#sub-vote}
To see all active and past referenda, navigate to the [Referenda tab](https://hydradx.subsquare.io/democracy/referenda) on Subsquare.

* Amount to vote - this is the amount of HDX tokens you are willing to lock in support of the referendum
* Conviction multiplier - this is the multiplier which co-determines the [weight of your vote](/democracy_referenda#referenda-votes-weighing).

After that, bring out your vote by clicking on *Vote yes* or *Vote no* and sign the transaction.
For first time and previous users, click on `Login` (top right corner) and connect your wallet.

### Propose a Referendum {#cw-propose}
To propose a referendum, visit the [HydraDX Commonwealth page](https://commonwealth.im/hydradx/) and click in the top menu on *New Thread > New democracy proposal*.
Click on an active referendum to see its details, the voting turnout, as well as the voting module.

<div style={{textAlign: 'center'}}>
<img src={useBaseUrl('/participate_in_referenda/cw-proposal.jpg')} />
<img src={useBaseUrl('/participate_in_referenda/sub-proposal.jpg')} />
</div>

Fill in the information in the fields show above. The most important parameters are:
* Module
* Function
* Any additional information as specified by the function that you are proposing to be called
* Deposit - the amount of HDX tokens which you are willing to deposit in support of the proposal
To cast your vote, click on `Vote` and provide the following information:

In the example above, the proposal module is *balances*, and the function is *setBalance* which modifies the free and reserve balances of a given account.
- **Vote with account** - select the voting account.
- **Value** - this is the amount of HDX tokens you are willing to lock in support of the referendum.
- **Vote lock** - this is the multiplier which co-determines the [weight of your vote](https://docs.hydradx.io/democracy_referenda#referenda-votes-weighing).

To submit the proposal, click on *Send transaction* and sign using your wallet.
After that, bring out your vote by clicking on *Nay* (No) or *Aye* (Yes) and sign the transaction.

After submitting the proposal on-chain and signing the transaction, your proposal should appear in the [list of proposed referenda](https://commonwealth.im/hydradx/referenda).
In the section *Cast Your Vote*, fill in the following information:

:::caution
Every voting period, the referendum proposal with the highest backing (*seconding*) enters the voting round. As the amount of referenda grows, there is no guarantee that your proposal will ever gain sufficient seconding to enter voting. There is no option to withdraw a referendum proposal, meaning that your funds might remain locked for a longer period of time.
* Amount to vote - this is the amount of HDX tokens you are willing to lock in support of the referendum
* Conviction multiplier - this is the multiplier which co-determines the [weight of your vote](/democracy_referenda#referenda-votes-weighing).

Malicious referendum proposals are punished. The HydraDX Council and the Technical Committee have the right to cancel any referendum which was proposed in bad faith. As a result, the deposited tokens will be burnt.
:::
After that, bring out your vote by clicking on *Vote yes* or *Vote no* and sign the transaction.

## Using Polkadot/apps {#polkajs}

Expand Down
Binary file removed static/howto_trade/trade_screen.jpg
Binary file not shown.
Binary file added static/howto_trade/trade_screen_st.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file removed static/participate_in_referenda/cw-proposal.jpg
Binary file not shown.
Binary file added static/participate_in_referenda/sub-proposal.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit 03aacf9

Please sign in to comment.