Skip to content

combining prior commits to one #127

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: main
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
26 changes: 15 additions & 11 deletions docs/governance/03-voting_process/01-linking_mainchain_address.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,39 +2,43 @@
title: Linking Mainchain and EON $ZEN Addresses
---

Because Snapshot is not compatible with Horizen’s mainchain, it has been integrated into EON, which is Ethereum-compatible. This means that $ZEN tokenholders will need to “link” their mainchain $ZEN address with an EON address in order to capture their full voting power for proposals in Snapshot.
| :warning: Disclaimer |
|:---------------------------|
| There is currently only technical support for linking balances held in Sphere to EON addresses. Other wallets like Arizen, Myzenwallet, etc. are unsupported for linking as are exchange balances. Moving Zen to Sphere is the only officially supported way to link Horizen Zen to EON. |

Because Snapshot is not compatible with Horizen’s mainchain, it has been integrated into EON, which is Ethereum-compatible. This means that $ZEN tokenholders will need to “link” their mainchain $ZEN address with an EON address in order to capture their full voting power for proposals in Snapshot.

## Overview

To enable voting power to all accounts within the Horizen ecosystem, the **Governance Linking** app provides a mechanism to link multiple mainchain addresses to one EON address. Upon linking, a user’s voting power for the Horizen DAO will be the sum total of their ZEN balance on EON, plus the ZEN balance of all of their linked mainchain addresses. This makes it easier for users to vote with the totality of their ZEN without having to move assets.
To enable voting power to all accounts within the Horizen ecosystem, the **Governance Linking** app provides a mechanism to link multiple mainchain addresses to one EON address. Upon linking, a user’s voting power for the Horizen DAO will be the sum total of their ZEN balance on EON, plus the ZEN balance of all of their linked mainchain addresses. This makes it easier for users to vote with the totality of their ZEN without having to move assets.

IMPORTANT NOTE: At this time, only $ZEN held in Sphere or on EON at the time of the voting snapshot will count towards voting power. $ZEN held elsewhere will not be captured. In advance of any vote, please ensure that all $ZEN you wish to vote with is held in Sphere or EON by the snapshot date. This date will be communicated to the community well before any vote.

### Configuring a Network

Before linking to an EON address, make sure that the appropriate network is available. If not, add the network to the EON wallet and set it as the primary network.
Before linking to an EON address, make sure that the appropriate network is available. If not, add the network to the EON wallet and set it as the primary network.

See [Connect your Wallet](/horizen_eon/connect/connect_your_wallet) in the EON documentation.


## Linking Addresses
## Linking Addresses

Perform the following steps to link one EON address to one or more mainchain addresses.

**Note:** MetaMask is used for providing the EON address.



1. Open the [Horizen Governance](https://eon.horizen.io/governance/dao) page.
1. Open the [Horizen Governance](https://eon.horizen.io/governance/dao) page.


<p>
<img src={require("/img/docs/dao/dao_gov_landingpage.png").default} alt="Gov Landing Page" width="700" height="500" />
</p>

2. Click **Connect Wallet**. The EON wallet (MetaMask) appears in the top-right corner. Once connected, the **EON address** field is automatically filled with the connected EON address.
2. Click **Connect Wallet**. The EON wallet (MetaMask) appears in the top-right corner. Once connected, the **EON address** field is automatically filled with the connected EON address.

**Note:** If the EON wallet (MetaMask) was previously connected to the Horizen Governance app, then it is automatically connected.
**Note:** If the EON wallet (MetaMask) was previously connected to the Horizen Governance app, then it is automatically connected.

<p>
<img src={require("/img/docs/dao/dao_gov_walletconnected2.png").default} alt="Wallet Connected" width="300" height="200" />
Expand Down Expand Up @@ -79,7 +83,7 @@ Perform the following steps to link one EON address to one or more mainchain add



9. The **Sign message with address** pop-up appears. Paste the EON address in the message field.
9. The **Sign message with address** pop-up appears. Paste the EON address in the message field.

<p>
<img src={require("/img/docs/dao/dao_sphere_sigcreate7.png").default} alt="Create Signature" width="300" height="200" />
Expand Down Expand Up @@ -124,16 +128,16 @@ Perform the following steps to link one EON address to one or more mainchain add



15. The **Linked Address** appears showing that the EON Address and Mainchain Address are linked.
15. The **Linked Address** appears showing that the EON Address and Mainchain Address are linked.

<p>
<img src={require("/img/docs/dao/dao_gov_linkmultiple4.png").default} alt="Addresses Linked" width="300" height="200" />
</p>


#### Link Multiple Mainchain Addresses
#### Link Multiple Mainchain Addresses

Repeat the steps discussed in Linking Addresses to link additional mainchain addresses with the EON address.
Repeat the steps discussed in Linking Addresses to link additional mainchain addresses with the EON address.


#### Unlink an Account
Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1,22 @@
---
title: Important Additional Information About Voting
---

## Voting Power Calculation

All Zen tokenholders get voting power, regardless of whether Zen is held on the Horizen mainchain or the EON sidechain. In addition, the ERC-20 representation of Zen (WZEN) counts in a user's voting power calculation. In particular, voting power for your EON address is calculated as the sum of the following four categories:

1. Mainchain Zen amount if linked to your EON address
2. Sidechain Zen amount held in your EON address
3. Sidechain WZEN amount held in your EON address
4. Any Zen delegated to this wallet address, from another wallet address to your EON address

## Snapshot Information

Snapshot is the third-party service provider for Horizen governance. It works by taking a "snapshot" of all wallet holdings as of a specified block height, and allows users to connect their wallets, sign a message and vote in an off-chain, gasless way so as to avoid having to pay money to vote. Because of the way that Snapshot works, there are some key points that everyone should be aware of:

* The Zen balances you hold in your wallets at the time of the snapshot will represent your voting power for the specified proposal
* Any amount of Zen moved to your wallet after the snapshot is taken will be ineligible for voting purposes for the specified proposal
* The linking of a Horizen mainchain address to an EON address can happen after the snapshot is taken, but must obviously be done before voting is closed for the specified proposal

It's also very important to note that as stated above, a snapshot of the blockchain's state is taken at the time of proposal creation. This means if you wish to link Zen from a mainchain address to a sidechain address, and you hold Zen any place other than Sphere, it must be moved to Sphere **prior to the creation of the proposal**. Please check with your community ambassadors or liaisons for guidance on when proposals are going to be created so as to be prepared for voting if you wish to participate.
2 changes: 2 additions & 0 deletions docs/governance/04-reference/02-submit_vote.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,8 @@
title: Submit or Vote on a Proposal
---

Discussions about proposals occur in Horizen's Discourse group. Please sign up and participate in discussions here:
[Discourse](https://horizen.discourse.group)

In order to participate in voting, you must connect your wallet to Snapshot and sign a message to cast your vote. The link to Snapshot is here:
[Snapshot](https://snapshot.org/#/horizenfoundation.eth)
54 changes: 54 additions & 0 deletions docs/horizen_eon/06-service_providers/01-eon_service_providers.md
Original file line number Diff line number Diff line change
Expand Up @@ -152,3 +152,57 @@ See the following Relink documentations for additional information:
Revoke.cash is a tool that helps you manage your wallet’s token approvals on over 60 networks. When using marketplace or exchange dApps, you have to grant them permission to spend your tokens and NFTs. This is called a token approval. If you don’t revoke these approvals, the dApp can spend your tokens forever. Revoke.cash allows you to inspect and revoke the approvals that you no longer use to prevent unwanted access to your funds.

See the [Revoke.cash](https://revoke.cash/) documentation for more information.

## Archon

One of Horizen's partners, Archon, has built a bridge on top of the LayerZero protocol. The bridge is here:

* [Archon bridge](https://bridge.archon.finance/)

#### EON NETWORK :
On the Horizen EON network, in order to received previously wrapped tokens from Ethereum and Avalanche in their original form, use the following:
* Contract name : "Wrapped Token Bridge"
* Contract address : 0xA2C2214dD03a60404C5AdeF4514E77fC00668592

In order to send Zen or other native assets to Ethereum, use the following:
* Contract name : "Original Token Bridge"
* Contract address : 0x4fd89120A6d34024Cb86a9a0d7819565Fe4eC351

In order to send Zen or other native assets to Avalanche, use the following:
* Contract name : Original Token Bridge
* Contract address : 0x7A302432D99DE20bc622e9148b690f22ef21436e

Finally, the following addresses are for a variety of bridged assets:
* EON contract address for Wrapped ETH : 0x2c2E0B0c643aB9ad03adBe9140627A645E99E054
* EON contract address for AVAX : 0x6318374DFb468113E06d3463ec5Ed0B6Ae0F0982
* EON contract address for USDC : 0xCc44eB064CD32AAfEEb2ebb2a47bE0B882383b53
* EON contract address for USDT : 0xA167bcAb6791304EDa9B636C8beEC75b3D2829E6
* EON contract address for DAI : 0x38C2a6953F86a7453622B1E7103b738239728754
* EON contract address for LINK : 0xDF8DBA35962Aa0fAD7ade0Df07501c54Ec7c4A89
* EON contract address for BTC : 0x1d7fb99AED3C365B4DEf061B7978CE5055Dfc1e7

#### ETHEREUM NETWORK :
On the Ethereum network, the following contract will receive Wrapped Zen (WZEN) from EON:
* Contract name : "Wrapped Token Bridge"
* Contract address : 0x8dE1Fb1F8a23202C7282716AE0089c6a96e07995

In order to wrap native Ethereum assets and send them to EON, use the following:
* Contract name : "Original Token Bridge"
* Contract address : 0x954367cb2028e704B62a4093f648BE453aCA3989

Finally, the contract address for Wrapped Zen on Ethereum is:
* Contract name : "Wrapped Zen"
* Contract address : 0xd21475D90686c9A6FDBe0849cb6670fEc2aC9E21


#### AVALANCHE NETWORK :
On the Avalanche network, the following contract will receive Wrapped Zen (WZEN) from EON:
* Contract name : "Wrapped Token Bridge"
* Contract address : 0xB2F5d60530C5E589bd9326e4c57933F611a624C6

In order to wrap native Avalanche assets and send them to EON, use the following:
* Contract name : "Original Token Bridge"
* Contract address : 0x0c81b1905125ED89C42a0aDa098adfd461f8A9C5

Finally, the contract address for Wrapped Zen on Avalanche is:
* Wrapped ZEN : 0xAA1dA1591cBF7f2Df46884E7144297FF15Ea3a7f
4 changes: 4 additions & 0 deletions sidebars.js
Original file line number Diff line number Diff line change
Expand Up @@ -219,6 +219,10 @@ module.exports = {
type: 'doc',
id: 'governance/voting_process/delegation',
},
{
type: 'doc',
id: 'governance/voting_process/important_voting_information',
},
],
},
{
Expand Down