Skip to main content

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.

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.

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.

See Connect your Wallet in the EON documentation.

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 page.

Gov Landing Page

  1. 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.

Wallet Connected

  1. Open Sphere and navigate to the mainchain wallet address you want to link to the EON address. Click the Information icon.

Wallet Connected

  1. The wallet address information pane appears. Click copy to obtain the address in a clipboard.

Wallet Connected

  1. In the Horizen Governance Linked Addresses pane, click Link Mainchain Address.
  2. The Link Address pop-up appears. Paste the Sphere wallet address in the Mainchain Address field.

Mainchain Address

Create a Signature in Sphere

  1. Copy the EON address from the connected wallet to the Horizen Governance app.
  2. In Sphere, go to the Addresses pane. Click the compose icon (hand holding pencil).

Compose Icon

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

Create Signature

  1. Click Create signature. The mainchain signature appears below the message field.

Copy Signature

  1. Click COPY TO CLIPBOARD.
  1. In the Horizen Governance Linked Addresses pane, paste the signature in the Mainchain Signature field.

Link Addresses

  1. Click Link. The Pending pop-up appears stating that the transaction is being submitted.

Pending Spin

  1. The MetaMask Notification appears. Read the information details. Click Confirm.

Wallet Notification

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

Addresses Linked

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

To unlink an account (mainchain address), perform the following steps:

  1. In the Horizen Governance Linked Addresses pane, select the desired account (mainchain address) you wish to unlink.

Unlinked Address

  1. Click on the Unlink icon. The Unlink Address pop-up appears.

Unlinked Address

  1. Click Unlink. The selected mainchain address is unlinked and no longer listed in the Linked Address pane.

Linking a Multisignature Wallet

Generating Signatures for Multisig Wallets

Before you can link your multisignature wallet you need to first create signatures for each of the signers for the multisignature address. In order to create a signature you will need the Sphere Wallet desktop application. Each signer will have to repeat the steps outlined below.

  1. Open Sphere and login to your account.
  2. On the left hand navigation, select the Wallet that is associated with (a signer of) the multisignature wallet you are trying to link.
  3. You will now be shown a list of addresses associated with that wallet. Select the handwriting icon for the address in question.

Sphere Handwriting Icon

  1. Next you will be shown a window for you to sign a message. Steps for this part are as follows:
    • Enter a value into the textbox which is a combination of the multisignature address and EON address you are trying to link.
      • Example: If your EON address is 0x7Ad67fa4da9f069940GE0A117A1ae57B0Eea4b49 and your multisignature address is zrAyfokUPmXVvmDAzXgCHJ6dpKqXnCwU6EK, then the value you should enter is as follows: 0x7Ad67fa4da9f069940GE0A117A1ae57B0Eea4b49zrAyfokUPmXVvmDAzXgCHJ6dpKqXnCwU6EK.
    • Select the Create Signature button.
    • Once your signature is shown to you, copy it to the clipboard by clicking the Copy to Clipboard button.

Sphere Handwriting Icon

  1. Save this signature somewhere as it will be used in the Linking Your Multisig step.

Note: Each user that is a signer to the multisignature wallet needs to repeat the steps above. For example, if there are four signers, then four signatures are needed. Once this is completed you can move to the Linking Your Multisig step.

Linking Your Multisig Wallet

Make sure you have created signatures for each wallet signer before beginning this step.

  1. Go to the EON dApp via https://eon.horizen.io/app/start-here.
  2. On the left hand navigation select Governance -> Horizen DAO and you will be brought to the wallet linking page.
  3. Connect your wallet by clicking the Connect Wallet button on the top right of the screen.
  4. Select the Link Mainchain Address button.

Linking Modal

  1. Once selected, the Link Address modal will appear.

    • Enter the mainchain address (multisignature) into the Mainchain Address field. This is the mainchain multisignature address you want to link to your EON address.

    Linking Modal Form

    • Enter the first signature in the Mainchain Signature field

    • Select the Advanced (Multisig) dropdown towards the bottom of the modal. This will open a new set of fields for you to enter.

      • Enter the redeem script into the Redeem Script field. This is the redeem script which was generated when you originally created your multisignature wallet.

      • You will see an additional field with a label “Enter mainchain signature #2”. Enter the second signature you have.

      • If there are more signatures please repeat the step by:

        • Selecting the Add Signature button.

        • Entering the subsequent signature into the new field that is displayed.

          Linking Modal Form

  1. Once all of the signatures have been added, select the Link button at the bottom of the modal. If all information was entered correctly then your wallets will be linked successfully.

Note: In case of a failure, it’s important to follow the steps very carefully. There is a higher likelihood of mistakes in the values entered because there are many steps and multiple individuals involved in this process.