Skip to content

Commit

Permalink
redirect users in gnosis step 3
Browse files Browse the repository at this point in the history
  • Loading branch information
@pablomendezroyo
pablomendezroyo committed Aug 6, 2024
1 parent 5c079ec commit 5bbe0d1
Showing 1 changed file with 19 additions and 45 deletions.
64 changes: 19 additions & 45 deletions docs/user/staking/gnosis-chain/solo.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -17,12 +17,12 @@ Similar to Ethereum mainnet, Dappnode makes it very easy to set up you Gnosis Ch
![Stakers](/img/gnosischain-staking-screenshot.png)

- **Execution Client** (Choose one):
- Nethermind Xdai (Available now)
- Gnosis Erigon (Coming soon!)
- Nethermind Xdai (Available now)
- Gnosis Erigon (Coming soon!)
- **Consensus Client** (Choose one):
- Lighthouse Gnosis
- Teku Gnosis
- Lodestar Gnosis
- Lighthouse Gnosis
- Teku Gnosis
- Lodestar Gnosis
- **Web3Signer Gnosis**

:::tip Checkpoint Sync is your friend for syncing Consensus Clients
Expand All @@ -40,20 +40,18 @@ This guide will use the [Gnosis Wagyu keygen tool](https://github.com/alexpeters
:::caution What are all these keys?
🔒 **Validator keys** will be online (stored in your Dappnode) and signing the blocks of the Gnosis Chain. You will create them from a **mnemonic phrase**, which is important to keep safe as it's the **only way** to regenerate these validator keys if you lose them.

🛡️ The damage of getting your **mnemonic phrase** compromised has been reduced dramatically since withdrawals have been activated, as you can create the keystores with a set withdrawal address and nobody can change that after, even if they get to your **mnemonic phrase**. Nevertheless, if you lose the keystore and the mnemonic, you will not be able to sign an exit message and you will be forced to validate forever.
🛡️ The damage of getting your **mnemonic phrase** compromised has been reduced dramatically since withdrawals have been activated, as you can create the keystores with a set withdrawal address and nobody can change that after, even if they get to your **mnemonic phrase**. Nevertheless, if you lose the keystore and the mnemonic, you will not be able to sign an exit message and you will be forced to validate forever.

🔑 **Withdrawal address** this brings us to the withdrawal address, which is the address that will receive all the balance above 1 GNO while your validator is active, and all your balance above 0 GNO when you exit the validator set. You need to keep this address safe as it's where your GNO will go, and cannot be changed.
🔑 **Withdrawal address** this brings us to the withdrawal address, which is the address that will receive all the balance above 1 GNO while your validator is active, and all your balance above 0 GNO when you exit the validator set. You need to keep this address safe as it's where your GNO will go, and cannot be changed.
:::

1. Download the latest release of the Gnosis Wagyu Key Gen from [here](https://github.com/alexpeterson91/Gnosis-Wagyu-Key-Gen/releases).

1) Download the latest release of the Gnosis Wagyu Key Gen from [here](https://github.com/alexpeterson91/Gnosis-Wagyu-Key-Gen/releases).


2) Disconnect from the internet, so it will be harder to have any leaks on the information you use, and open the Gnosis Wagyu keygen tool. You will be given 2 options, either create a new mnemonic or import an existing mnemonic. The GUI is very user friendly and explains all steps along the way.
2. Disconnect from the internet, so it will be harder to have any leaks on the information you use, and open the Gnosis Wagyu keygen tool. You will be given 2 options, either create a new mnemonic or import an existing mnemonic. The GUI is very user friendly and explains all steps along the way.

![Gnosis Wagyu - 1st screen](/img/gnosis-wagyu1.png)

You will be shown your Mnemonic Phrase. Keep it safe, as it is used to recreate the validator keys! We recommend copying it in an encrypted volume or in paper stored in a safe place.
You will be shown your Mnemonic Phrase. Keep it safe, as it is used to recreate the validator keys! We recommend copying it in an encrypted volume or in paper stored in a safe place.

To ensure that you have copied it somewhere, it will ask you to type it again.

Expand Down Expand Up @@ -81,13 +79,13 @@ You are now done with the key generation process, and your generated keys and de
💡 *`Want to learn more about Ethereum keys and key generation?`*💡[Learn more](https://ethereum.org/en/developers/docs/consensus-mechanisms/pos/keys/#two-types-of-keys)
:::

Now that you’ve generated your deposit data and keystores, go ahead and upload your keystores to Web3Signer Gnosis, the package that you installed during step 1.
Now that you’ve generated your deposit data and keystores, go ahead and upload your keystores to Web3Signer Gnosis, the package that you installed during step 1.

Return to the Dappnode UI and navigate to the Stakers > Gnosis Chain menu. Your Web3Signer will have a link saying `Upload Keystores` . If it doesn’t, make sure that you have waited enough time since step 1 for all the packages to be installed (around 5 minutes) and refresh the page.

Then click on the `Import Keystores` button on the lower part of the Web3Signer Gnosis UI.

Here browse for the keystore file(s) you generated in the previous step and enter them along with the password you chose to secure your keystores.
Here browse for the keystore file(s) you generated in the previous step and enter them along with the password you chose to secure your keystores.

You are now ready to fund these validator accounts and start validating!

Expand All @@ -97,48 +95,23 @@ The final step is to fund your validator with 1 GNO necessary to register as a v

To do this, you will need to send 1 GNO to the Gnosis Chain deposit contract.

Navigate to [the Gnosis Chain deposit launchpad](https://deposit.gnosischain.com/)

![Gnosis Launchpad 1](/img/gnosis-launchpad1.png)

Under the Deposit tab, you'll find a box where you can import the `deposit_data.json` file you generated in Step 2. You can find it in the same folder you chose when generating the keys.

![Gnosis Launchpad 2](/img/gnosis-launchpad2.png)

The app will validate the json file and list the number of validator deposits you are making and the required GNO to deposit. Click Deposit to continue.

![Gnosis Launchpad 3](/img/gnosis-launchpad3.png)

Check that you understand the risks and [ensure you are interacting with the correct contract](https://docs.gnosischain.com/node/manual/validator/deposit#step-5-verify-transaction-parameters) before proceeding.

![Gnosis Launchpad 4](/img/gnosis-launchpad4.png)
![Gnosis Launchpad 5](/img/gnosis-launchpad5.png)

The moment to do the deposit is here! Connect your wallet with the GNO's you'll be depositing, and follow the steps to send the GNOs to the deposit contract!

:::warning
Please review the deposit address in the next step! MAKE SURE YOU ARE SENDING YOUR GNO FUNDS TO THE RIGHT DEPOSIT ADDRESS!
:::

![Gnosis Launchpad 6](/img/gnosis-launchpad6.png)
![Gnosis Launchpad 7](/img/gnosis-launchpad7.png)
Follow the official instructions in the [Gnosis Chain documentation](https://docs.gnosischain.com/node/manual/validator/deposit) to deposit your GNO into the deposit contract.

After the deposit is gone, you will be able to check the progress of your deposit by searching for your validator key in the [Gnosis Beacon Chain Explorer](https://gnosischa.in/), which is a fork of the [Ethereum Beaconcha.in](https://beaconcha.in/) explorer. You can get a direct link to this by clicking on the `View in Beaconcha.in` button in the upper, right corner of the Dappnode Web3signer Gnosis UI, where you uploaded the keystores.

**Remember**: Embarking on the staking journey requires diligence. Always keep abreast of developments and make informed decisions.


## Withdrawing my GNO

Once you want to finish your staking journey, you will need to withdraw your GNO from the Gnosis Chain. This is a 2 step process of exiting the validator from the Dappnode UI and claiming the GNO from the deposit contract.
Once you want to finish your staking journey, you will need to withdraw your GNO from the Gnosis Chain. This is a 2 step process of exiting the validator from the Dappnode UI and claiming the GNO from the deposit contract.

:::info Gnosis Chain withdrawals ≠ Ethereum withdrawals
Because the native token of Gnosis Chain is xDAI (you pay fees in it), but the staking token is GNO, withdrawals work differntly than in the Ethereum chain and do not happen automatically. You must claim your withdrawn tokens from the Deposit Contract. More info [here](https://docs.gnosischain.com/node/management/withdrawals).
:::

### 1. Exit the validator from the Dappnode UI

:::warning
:::warning
Make sure that your validator have a `0x01` type withdrawal address before exiting your validator or you will lose your funds. In the [consensus explorer](https://gnosischa.in/), if your withdrawal address shows as an address that starts with a `0x00` it means that your withdrawal address needs to be upgraded to a `0x01`, please refer to the guide in the [Gnosis Chain documentation](https://docs.gnosischain.com/node/management/withdrawals#how-to-change-the-withdrawal-credential). If your validator already shows a `0x01` address, you DON'T need to follow these steps.
:::

Expand All @@ -148,21 +121,22 @@ Navigate to the Stakers > Gnosis Chain menu and click on the `Upload Keystores`
Once you are in the Web3Signer UI, select the validators you want to exit and click on the `Exit Validator` button on the top right part of the UI.
Follow the instructions and type "I want to exit", followed by `Exit`.

Now the message to exit will be broadcasted to the network.
Now the message to exit will be broadcasted to the network.

:::caution Withdrawal queue
Your validator will not exit immediately. It will be queued to exit and you can track when it's due in the [Gnosis Beacon Chain Explorer](https://gnosischa.in/).
Your validator will not exit immediately. It will be queued to exit and you can track when it's due in the [Gnosis Beacon Chain Explorer](https://gnosischa.in/).
Even then, you will need to claim your GNO from the deposit contract as per the next step.
:::

### 2. Claim your GNO from the deposit contract

As soon as your withdrawal has been processed by the Beacon Chain, you will be able to claim your GNO from the deposit contract. You can claim from any of your wallets that hold xDAI to pay gas fees.

1. Go to the [Gnosis Chain Deposit Contract page in Gnosisscan.io](https://gnosisscan.io/address/0x0b98057ea310f4d31f2a452b414647007d1645d9#writeProxyContract#F3) and navigate to the `Write as Proxy` tab,

2. Connect your wallet with the `Connect to Web3` button and then locate the `3. claimWithdrawal` function.

3. Type your withdrawal address in the field and click `Write`. A transaction should trigger on your wallet. Approve it and wait for it to be included in a block.
3. Type your withdrawal address in the field and click `Write`. A transaction should trigger on your wallet. Approve it and wait for it to be included in a block.

![Claiming from the Smart Contract](/img/gnosiswithdrawals2.png)

Expand Down

0 comments on commit 5bbe0d1

Please sign in to comment.