Skip to content
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

Revamp Validator Docs #159

Merged
merged 163 commits into from
Nov 23, 2022
Merged
Show file tree
Hide file tree
Changes from 1 commit
Commits
Show all changes
163 commits
Select commit Hold shift + click to select a range
14c7c82
Merge pull request #132 from gnosischain/main
alebanzas Sep 15, 2022
7e00cb2
Merge pull request #136 from gnosischain/main
alebanzas Sep 21, 2022
01b3fd7
Merge pull request #141 from gnosischain/main
alebanzas Sep 23, 2022
378ef59
scaffolding node section
alebanzas Sep 28, 2022
40ef081
Merge pull request #161 from gnosischain/main
giacomolicari Sep 29, 2022
333ddf1
Merge pull request #171 from gnosischain/main
alebanzas Oct 3, 2022
c9f8516
Merge pull request #181 from gnosischain/main
alebanzas Oct 20, 2022
201207f
Merge pull request #183 from gnosischain/main
alebanzas Oct 20, 2022
fc9e415
changes PR-159
Nov 2, 2022
9d0b89d
Merge pull request #198 from gnosischain/main
plato-gno Nov 2, 2022
cb38d48
Merge pull request #200 from gnosischain/main
plato-gno Nov 3, 2022
87fb03b
removing blank spaces
alebanzas Nov 3, 2022
d85d155
removing old guide
alebanzas Nov 3, 2022
8e9e9ba
remove unused plugin
alebanzas Nov 3, 2022
4b05fed
scaffolding installation guide based on Prysm docs
alebanzas Nov 4, 2022
94932d3
minor
alebanzas Nov 4, 2022
87a59da
fix category
alebanzas Nov 4, 2022
a42b934
views refactor + jwt generator
alebanzas Nov 4, 2022
06c0499
minor
alebanzas Nov 4, 2022
b548b68
scaffold EL client setup
alebanzas Nov 4, 2022
6d77b68
Add revised Validator Docs tree
plato-gno Nov 9, 2022
0399aab
Migrate docs from Old Docs
plato-gno Nov 9, 2022
82524a9
jwt file location
alebanzas Nov 9, 2022
493fdce
minor
alebanzas Nov 9, 2022
2959c80
nethermind windows
alebanzas Nov 9, 2022
0440527
Add pages to Node section
plato-gno Nov 9, 2022
03dd032
Merge main
plato-gno Nov 9, 2022
3c6e6fa
nethermind linux
alebanzas Nov 9, 2022
a330ee7
ease the process
alebanzas Nov 13, 2022
9df9a8a
open port for CL comms
alebanzas Nov 13, 2022
877806a
ease the process
alebanzas Nov 13, 2022
7260d6d
consensus layer lighthouse
alebanzas Nov 13, 2022
e2d3b0a
checkpoint flag
alebanzas Nov 13, 2022
7d4935d
minor
alebanzas Nov 14, 2022
f93e3cc
simplification
alebanzas Nov 14, 2022
09f72a5
install validator tabs
alebanzas Nov 14, 2022
1dedd8d
avoid confusion
alebanzas Nov 14, 2022
4a66bc2
dividing in steps based on agreed structure
alebanzas Nov 14, 2022
1e30088
Merge pull request #204 from gnosischain/127-validator-docs-tree
plato-gno Nov 14, 2022
d62b10d
DOM fix
alebanzas Nov 14, 2022
67ecfb9
generate validator keys
alebanzas Nov 14, 2022
081d6ee
Merge pull request #209 from gnosischain/main
alebanzas Nov 14, 2022
e43ffa5
Merge branch 'main' into node-setup-tabs
alebanzas Nov 14, 2022
63994c5
Merge branch '127-validators' into node-setup-tabs
alebanzas Nov 14, 2022
bc72a88
Merge branch 'release' into node-setup-tabs
alebanzas Nov 14, 2022
5ba5d53
refactor
alebanzas Nov 15, 2022
aca9e39
agreed folder structure
alebanzas Nov 16, 2022
a41fdb4
checkpoint service up!
alebanzas Nov 16, 2022
2082fe8
generating keys in the correct folder
alebanzas Nov 16, 2022
2fef0c9
lighthouse validator setup
alebanzas Nov 16, 2022
09769d3
Merge pull request #216 from gnosischain/node-setup-tabs
alebanzas Nov 16, 2022
6778dc0
hide unused dimension
alebanzas Nov 16, 2022
0e49312
fix to deeplink
alebanzas Nov 17, 2022
0eb0a51
correct gno on chiado address + fixes
alebanzas Nov 17, 2022
f7e178f
Partial completion of Overview page, refactor navigation tree
plato-gno Nov 17, 2022
3462200
Interim merge to 127 to establish doc tree
plato-gno Nov 18, 2022
0ad5cd3
Merge pull request #218 from gnosischain/217-overview
plato-gno Nov 18, 2022
48197a2
clients url refactor
alebanzas Nov 18, 2022
1447acd
moving interactive guide
alebanzas Nov 18, 2022
7837399
jwt page
alebanzas Nov 18, 2022
196f54a
correct order
alebanzas Nov 18, 2022
c727705
removing old pages
alebanzas Nov 18, 2022
cbf5373
typo
alebanzas Nov 18, 2022
c61d4ef
node management home
alebanzas Nov 18, 2022
836f968
oe deprecation
alebanzas Nov 18, 2022
fbba247
moving FAQs to node section
alebanzas Nov 18, 2022
61d0499
remove duplication of info
alebanzas Nov 18, 2022
de4bf0e
WIP bringing remote content
alebanzas Nov 18, 2022
890a9aa
massive link fixing
alebanzas Nov 18, 2022
e1cdfb8
Merge branch '127-validators' into remote-content
alebanzas Nov 18, 2022
996fda6
Add Rewards and Penalties section
plato-gno Nov 18, 2022
d02dc55
Merge 127 main
plato-gno Nov 18, 2022
fecd337
Add node architecture drawio diagram
plato-gno Nov 18, 2022
f8cdd2a
Merge pull request #220 from gnosischain/217-overview
plato-gno Nov 18, 2022
2f856bb
DAppNode instructions for purchased servers and script installation
jbradach Nov 19, 2022
858fbeb
updated lighthouse
CVJoint Nov 19, 2022
835f973
updated lighthouse compose formatting
CVJoint Nov 19, 2022
4c6cc87
updated teku
CVJoint Nov 19, 2022
b7cd5d7
updated teku
CVJoint Nov 21, 2022
cfddc4a
update lighthouse
CVJoint Nov 21, 2022
6646630
updated lodestar
CVJoint Nov 21, 2022
1dcc215
update teku
CVJoint Nov 21, 2022
a749d39
Complete Node Architecture Page
plato-gno Nov 21, 2022
2b4a23f
Merge pull request #221 from gnosischain/194-node-architecture
plato-gno Nov 21, 2022
c7d5b7d
Refactor Validator Docs structure and Sidebar
plato-gno Nov 21, 2022
4fec636
Minor changes
plato-gno Nov 21, 2022
d598766
fixing code block
alebanzas Nov 21, 2022
954b072
fixing code block + headings
alebanzas Nov 21, 2022
3afb0fc
fixing headings
alebanzas Nov 21, 2022
facf1bc
fixing headings
alebanzas Nov 21, 2022
f6d12f6
fixing code block
alebanzas Nov 21, 2022
5059cfb
minor
alebanzas Nov 21, 2022
f03a825
minor
alebanzas Nov 21, 2022
caba2f5
adding title
alebanzas Nov 21, 2022
08ae296
adding title
alebanzas Nov 21, 2022
13e5138
adding title
alebanzas Nov 21, 2022
e4e6721
refactor + link fixing
alebanzas Nov 21, 2022
bececa9
caution to tip
alebanzas Nov 21, 2022
6848c14
typo fix and change to jwt.hex
CVJoint Nov 21, 2022
4335974
Merge upstream
plato-gno Nov 21, 2022
6353a2d
typo fix and change to jwt.hex
CVJoint Nov 21, 2022
9f68c8f
typo fix and change to jwt.hex
CVJoint Nov 21, 2022
f25baf5
Merge pull request #222 from gnosischain/147-lighthouse
alebanzas Nov 21, 2022
5e8b6ec
Merge pull request #223 from gnosischain/149-teku
alebanzas Nov 21, 2022
00b1f06
Merge pull request #224 from gnosischain/151-lodestar
alebanzas Nov 21, 2022
238b4b8
index of folders
alebanzas Nov 21, 2022
515c771
minor
alebanzas Nov 21, 2022
d2d7917
link fix
alebanzas Nov 21, 2022
f8825ea
fix
alebanzas Nov 21, 2022
4642cd3
Merge branch '127-validators' into 127-refactor-structure
alebanzas Nov 21, 2022
e2b595c
Merge pull request #225 from gnosischain/127-refactor-structure
alebanzas Nov 21, 2022
1613063
fixing headings
alebanzas Nov 21, 2022
21b9dfe
index of folders
alebanzas Nov 21, 2022
6275a24
execution layer minor changes
alebanzas Nov 21, 2022
b6d08c1
minor fixed to beacon clients
alebanzas Nov 21, 2022
283e019
Merge branch '127-validators' into remote-content
alebanzas Nov 21, 2022
f41d396
new sidebar structure
alebanzas Nov 21, 2022
0b5bad5
changing original content
alebanzas Nov 21, 2022
ca820b9
generate keys + link to docs
alebanzas Nov 21, 2022
06551b1
minor
alebanzas Nov 21, 2022
ba54bc0
Merge pull request #226 from gnosischain/remote-content
alebanzas Nov 22, 2022
d5029e2
warning comment
alebanzas Nov 22, 2022
1a34972
alpha order
alebanzas Nov 22, 2022
64b5998
voluntary exit
alebanzas Nov 22, 2022
a07a5ac
sedge wording + cleanning
alebanzas Nov 22, 2022
a2790fd
more resources
alebanzas Nov 22, 2022
dfb0267
deep links
alebanzas Nov 22, 2022
af4f4f7
verify validator status
alebanzas Nov 22, 2022
5f6daf3
order
alebanzas Nov 22, 2022
7dcda37
Reorganize partials to be by folder
plato-gno Nov 22, 2022
faac67b
fix
alebanzas Nov 22, 2022
d82500c
migrating validator
alebanzas Nov 22, 2022
7ac33e1
Finish Configure Server section
plato-gno Nov 22, 2022
8a06ad5
path fix + using partial in run a validator
alebanzas Nov 22, 2022
3885633
link fix
alebanzas Nov 22, 2022
69a9da6
Merge pull request #230 from gnosischain/127-organize-partials-by-folder
alebanzas Nov 22, 2022
4270d3f
Merge pull request #233 from gnosischain/231-prepare-server
alebanzas Nov 22, 2022
664a369
minor refactor
alebanzas Nov 22, 2022
3e912a7
adding title
alebanzas Nov 22, 2022
9b32be4
Refactor Fund a Validator section
plato-gno Nov 22, 2022
5d07ea5
link fix
alebanzas Nov 22, 2022
d69d8c9
internal link to fund validator
alebanzas Nov 22, 2022
510bed6
fund validator step
alebanzas Nov 22, 2022
1236e66
disable unsupported clients
alebanzas Nov 22, 2022
26c7989
Note that client is not ready for public use.
jbradach Nov 22, 2022
2376063
Moved Nimbus and Prysm to end
jbradach Nov 22, 2022
ddc9ade
updated nethermind, removed validator from CL clients
CVJoint Nov 23, 2022
1b2b1ad
Merge pull request #237 from gnosischain/228-fund-validator
plato-gno Nov 23, 2022
1142867
Merge branch '127-validators' into 229-add-partials
plato-gno Nov 23, 2022
c33a584
Amend Beacon Node and validator writeups for CL clients
plato-gno Nov 23, 2022
2e03fef
Merge branch '127-validators' into 229-split-EL-CL-validator
plato-gno Nov 23, 2022
1e0cfc9
Merge branch '229-split-EL-CL-validator' into 229-add-partials
plato-gno Nov 23, 2022
6448317
disable unsupported
alebanzas Nov 23, 2022
1417366
Merge pull request #249 from gnosischain/242-disable-buttons
alebanzas Nov 23, 2022
754ed3f
Merge pull request #248 from gnosischain/229-add-partials
alebanzas Nov 23, 2022
fa7d75f
Refactor partials into subfolders
plato-gno Nov 23, 2022
df55064
Refactor HTML into Markdown
plato-gno Nov 23, 2022
2fe3dee
Merge pull request #246 from gnosischain/229-split-EL-CL-validator
alebanzas Nov 23, 2022
91eda8a
typo
alebanzas Nov 23, 2022
4053d25
Update partials for Interactive Guide with placeholder links
plato-gno Nov 23, 2022
745d5a8
Merge pull request #250 from gnosischain/229-add-cl-el-partials
alebanzas Nov 23, 2022
a6ab468
Merge pull request #251 from gnosischain/229-add-partials
alebanzas Nov 23, 2022
07edf86
Merge branch 'main' into 127-validators
alebanzas Nov 23, 2022
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
4 changes: 2 additions & 2 deletions docs/about/tokens/gno.md
Original file line number Diff line number Diff line change
Expand Up @@ -86,13 +86,13 @@ Check out [Chiado Testnet specs](/about/networks/chiado#gno-token) for more info

#### mGNO token

To create a more accurate ETH-mirrored environment, a minimum of 32 tokens are used for staking purposes on the Gnosis Beacon Chain. The mGNO token is a meta-token similar to a wrapped token created for this purpose. During deposits, 1 GNO is automatically converted to 32 mGNO. Check the [deposit process](/node/validator-deposits) for more details.
To create a more accurate ETH-mirrored environment, a minimum of 32 tokens are used for staking purposes on the Gnosis Beacon Chain. The mGNO token is a meta-token similar to a wrapped token created for this purpose. During deposits, 1 GNO is automatically converted to 32 mGNO. Check the [deposit process](/node/deposit) for more details.

- mGNO contract on Gnosis: [0x722fc4DAABFEaff81b97894fC623f91814a1BF68](https://gnosisscan.io/address/0x722fc4DAABFEaff81b97894fC623f91814a1BF68)

#### Staking

Stake your GNO tokens to secure Gnosis validating blocks as part of the PoS consensus. Check the [deposit process](/node/validator-deposits) for more details.
Stake your GNO tokens to secure Gnosis validating blocks as part of the PoS consensus. Check the [deposit process](/node/deposit) for more details.

Liquid staking providers allow anyone to stake without running the infrastructure themselves. Check the [Stakewise](/tools/beacon-chain/liquid-staking#tokens-sgno--rgno) page for more details on sGNO and rGNO tokens.

Expand Down
34 changes: 2 additions & 32 deletions docs/node/README.md
Original file line number Diff line number Diff line change
@@ -1,35 +1,5 @@
---
description: Gnosis Beacon Chain Documentation
slug: ./
title: Overview
---

# Gnosis Beacon Chain

Gnosis Beacon Chain (GBC) brings extendable and accelerated beacon-network functionality to the Ethereum ecosystem. Applications can iterate through real-world strategies, stage important applications, or choose to run DApps in a faster, lower-stakes environment while enjoying the benefits of massive scalability.

GBC is optimized for certain parameters (block/epoch time) and can serve in a frontrunning capacity to important Ethereum consensus-layer updates. For example, the merge will first take place on testnets. Once thorough testing is complete, updates can then move to a production-level, real-world value environment (Gnosis Beacon Chain).

Validating on the GBC only requires the equivalent of 1 [GNO](/about/tokens/gno), opening up validation opportunities for diverse groups of individuals across the globe. When you go to make the deposit, that 1 GNO is split into 32 mGNO to more closely mirror Ethereum, where you stake 32 ETH.

## What is Staking?
Currently, Gnosis uses Parity's [AuRa](https://openethereum.github.io/Aura) proof-of-authority consensus model. In this model, selected validators (selected through the POSDAO dPOS process) take turns signing blocks. However, after the merge, Gnosis will be running a consensus protocol known as [Proof of Stake](https://www.investopedia.com/terms/p/proof-stake-pos.asp). To secure the network and disincentivize bad actors from validating invalid or non-existent transactions, validators "stake" a non-trivial amount of assets. If they are caught lying by other validators, their stake gets "slashed" (taken away), and they can be permanently removed from the validator pool. In order for the network to be compromised, bad actors would have to control 51% of the staked assets, in what's known as a [51% attack](https://www.investopedia.com/terms/1/51-attack.asp). Therefore, the more validators, the more coins there are being staked, and the more expensive and infeasible a 51% attack becomes. In exchange for being a good validator, a portion of transaction fees are paid out. On Gnosis, rewards are paid out in mGNO (1 mGNO = 1/32 GNO).

## What is a Node?
A 'node' on Gnosis is very similar to a node on Ethereum. [Read more here](https://ethereum.org/en/run-a-node/)

## What is Meant by 'Consensus Layer' and 'Execution Layer'?
The ***Consensus Layer*** is responsible for the blockchain's consensus. Pre-merge, this is known as the ***Beacon Chain***. This is where the validators check and make sure that blocks are valid. To run this, we can use clients such as [Lighthouse](https://github.com/sigp/lighthouse), [Prysm](https://github.com/prysmaticlabs/prysm), [Nimbus](https://github.com/status-im/nimbus-eth2), or [Teku](https://github.com/ConsenSys/teku).

The ***Execution Layer*** is responsible for transaction bundling and execution. To run this, we use clients like Nethermind.

In order to check validity, the Consensus Layer sends a list of transactions and other data required to execute and validate them. The execution layer then assembles whats known as an execution block, verifies some pre-conditions, executes the transactions and then verifies the post-conditions. The result is then sent to the Consensus Layer. [This HackMD post](https://hackmd.io/@n0ble/ethereum_consensus_upgrade_mainnet_perspective) goes into more detail on how the layers interact. Note that any mention of transition from Proof of Work (PoW) does not apply to Gnosis.


:::tip
🙋🏼‍♀️ Want to run a GBC validator node with ease? [DappNode](https://dappnode.io) provides hardware solutions and step-by-step setup, plus an opportunity to get up to 4 validators free with purchase. [Learn More](https://shop.dappnode.io/product/dappnodextreme-gnosis/).
:::

:::tip
Liquid staking is the easiest way to participate, and you can do so with [Stakewise](https://app.stakewise.io). [Read more here](/tools/beacon-chain/liquid-staking).
:::

# Run Gnosis
5 changes: 5 additions & 0 deletions docs/node/deposit.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
---
description: Deposit
---

# Deposit
5 changes: 5 additions & 0 deletions docs/node/exit.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
---
description: Exit
---

# Exit
35 changes: 2 additions & 33 deletions docs/node/incentives.md
Original file line number Diff line number Diff line change
@@ -1,36 +1,5 @@
---
description: Incentives
---

# Incentives

## Gnosis Beacon Chain Validator Rewards

The minimum requirement to run a validator is 1 [GNO](/about/tokens/gno) (staked as 32 mGNO tokens). Rewards are based on the number of validators securing the chain.

| GNO staked | % of GNO validating | reward for validators | Total GNO rewards | Overall inflation p.a. |
| ---------- | ------------------- | --------------------- | ----------------- | ---------------------- |
| 4096 | 0.23% | 83.85% | 3434.496 | 0.19% |
| 50000 | 2.78% | 23.01% | 11505 | 0.64% |
| 100000 | 5.56% | 16.65% | 16650 | 0.93% |
| 200000 | 11.11% | 11.89% | 23780 | 1.32% |
| 400000 | 22.22% | 8.45% | 33800 | 1.88% |
| 800000 | 44.44% | 5.99% | 47920 | 2.66% |
| 1800000 | 100.00% | 4.00% | 72000 | 4.00% |

:::note
[APY Calculator](https://www.desmos.com/calculator/7pzueggivw) for the rewards curve. The Y axis is APR and the X axis is the number of validators multiplied by 100.

Following parameters set for the calculation.

F: Block reward factor = 25

T: Time between blocks = 5

S: Slots in an epoch= 16

N: amount of validators required for the launch = 4096
:::

## Current Yield View

To view the current validator reward percentage and other deposit statistics, see the [Gnosis Beacon Chain Dune Analytics dashboard](https://dune.xyz/maxaleks/Gnosis-Beacon-Chain-\(Deposits\)).
# Incentives
5 changes: 5 additions & 0 deletions docs/node/migrate.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
---
description: Migrate
---

# Migrate
5 changes: 5 additions & 0 deletions docs/node/monitor.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
---
description: Monitor
---

# Monitor
5 changes: 5 additions & 0 deletions docs/node/requirements.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
---
description: Requirements
---

# Requirements
11 changes: 11 additions & 0 deletions docs/node/setup/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
---
title: Setup
---

# Setup


## Execution Layer


## Consensus Layer
5 changes: 5 additions & 0 deletions docs/node/setup/besu.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
---
description: Setup
---

# Besu
5 changes: 5 additions & 0 deletions docs/node/setup/dappnode.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
---
description: DappNode
---

# DappNode
5 changes: 5 additions & 0 deletions docs/node/setup/erigon.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
---
description: Setup
---

# Erigon
5 changes: 5 additions & 0 deletions docs/node/setup/generate-keys.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
---
description: Generate Keys
---

# Generate Keys
5 changes: 5 additions & 0 deletions docs/node/setup/geth.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
---
description: Setup
---

# Geth
5 changes: 5 additions & 0 deletions docs/node/setup/lighthouse.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
---
description: Setup
---

# Lighthouse
5 changes: 5 additions & 0 deletions docs/node/setup/lodestar.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
---
description: Setup
---

# Lodestar
5 changes: 5 additions & 0 deletions docs/node/setup/nethermind.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
---
description: Setup
---

# Nethermind
5 changes: 5 additions & 0 deletions docs/node/setup/nimbus.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
---
description: Setup
---

# Nimbus
5 changes: 5 additions & 0 deletions docs/node/setup/open-ethereum.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
---
description: Setup
---

# Open Ethereum
5 changes: 5 additions & 0 deletions docs/node/setup/prysm.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
---
description: Setup
---

# Prysm
5 changes: 5 additions & 0 deletions docs/node/setup/teku.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
---
description: Setup
---

# Teku
5 changes: 5 additions & 0 deletions docs/node/update.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
---
description: Update
---

# Update
5 changes: 5 additions & 0 deletions docs/node/withdraw.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
---
description: Withdraw
---

# Withdraw
35 changes: 35 additions & 0 deletions docs/nodeOld/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,35 @@
---
description: Gnosis Beacon Chain Documentation
slug: ./
---

# Gnosis Beacon Chain

Gnosis Beacon Chain (GBC) brings extendable and accelerated beacon-network functionality to the Ethereum ecosystem. Applications can iterate through real-world strategies, stage important applications, or choose to run DApps in a faster, lower-stakes environment while enjoying the benefits of massive scalability.

GBC is optimized for certain parameters (block/epoch time) and can serve in a frontrunning capacity to important Ethereum consensus-layer updates. For example, the merge will first take place on testnets. Once thorough testing is complete, updates can then move to a production-level, real-world value environment (Gnosis Beacon Chain).

Validating on the GBC only requires the equivalent of 1 [GNO](/about/tokens/gno), opening up validation opportunities for diverse groups of individuals across the globe. When you go to make the deposit, that 1 GNO is split into 32 mGNO to more closely mirror Ethereum, where you stake 32 ETH.

## What is Staking?
Currently, Gnosis uses Parity's [AuRa](https://openethereum.github.io/Aura) proof-of-authority consensus model. In this model, selected validators (selected through the POSDAO dPOS process) take turns signing blocks. However, after the merge, Gnosis will be running a consensus protocol known as [Proof of Stake](https://www.investopedia.com/terms/p/proof-stake-pos.asp). To secure the network and disincentivize bad actors from validating invalid or non-existent transactions, validators "stake" a non-trivial amount of assets. If they are caught lying by other validators, their stake gets "slashed" (taken away), and they can be permanently removed from the validator pool. In order for the network to be compromised, bad actors would have to control 51% of the staked assets, in what's known as a [51% attack](https://www.investopedia.com/terms/1/51-attack.asp). Therefore, the more validators, the more coins there are being staked, and the more expensive and infeasible a 51% attack becomes. In exchange for being a good validator, a portion of transaction fees are paid out. On Gnosis, rewards are paid out in mGNO (1 mGNO = 1/32 GNO).

## What is a Node?
A 'node' on Gnosis is very similar to a node on Ethereum. [Read more here](https://ethereum.org/en/run-a-node/)

## What is Meant by 'Consensus Layer' and 'Execution Layer'?
The ***Consensus Layer*** is responsible for the blockchain's consensus. Pre-merge, this is known as the ***Beacon Chain***. This is where the validators check and make sure that blocks are valid. To run this, we can use clients such as [Lighthouse](https://github.com/sigp/lighthouse), [Prysm](https://github.com/prysmaticlabs/prysm), [Nimbus](https://github.com/status-im/nimbus-eth2), or [Teku](https://github.com/ConsenSys/teku).

The ***Execution Layer*** is responsible for transaction bundling and execution. To run this, we use clients like Nethermind.

In order to check validity, the Consensus Layer sends a list of transactions and other data required to execute and validate them. The execution layer then assembles whats known as an execution block, verifies some pre-conditions, executes the transactions and then verifies the post-conditions. The result is then sent to the Consensus Layer. [This HackMD post](https://hackmd.io/@n0ble/ethereum_consensus_upgrade_mainnet_perspective) goes into more detail on how the layers interact. Note that any mention of transition from Proof of Work (PoW) does not apply to Gnosis.


:::tip
🙋🏼‍♀️ Want to run a GBC validator node with ease? [DappNode](https://dappnode.io) provides hardware solutions and step-by-step setup, plus an opportunity to get up to 4 validators free with purchase. [Learn More](https://shop.dappnode.io/product/dappnodextreme-gnosis/).
:::

:::tip
Liquid staking is the easiest way to participate, and you can do so with [Stakewise](https://app.stakewise.io). [Read more here](/tools/beacon-chain/liquid-staking).
:::

Original file line number Diff line number Diff line change
Expand Up @@ -194,8 +194,8 @@ If you prefer a beginner-friendly walkthrough from start to finish, this excelle
1. [Generate Validator Keystores and Deposit Data](#step-1-generate-validator-accounts-and-deposit-data): On an offline machine, generate up to 128 separate validator keys per node.
2. [Choose your Gnosis Beacon Chain (GBC) Client:](#step-2-choose-your-beacon-chain-client--import-validator-keys) Choose to run either Prysm, Lighthouse or Nimbus. Add keystores and env variables.
3. [Start up your GBC Node](#step-3-run-the-beacon-chain-node-with-the-attached-validator-process): Run in the docker container.
4. [Deposit to your Validator(s)](/node/validator-deposits): Use the Deposit UI to convert GNO to mGNO (metaGNO for staking) and deposit to your validator.
5. [View on Explorer](/node/monitoring-nodes): Wait \~1.5-2 hours for your validator(s) to go live and view at [https://beacon.gnosischain.com](https://beacon.gnosischain.com).
4. [Deposit to your Validator(s)](/node/deposit): Use the Deposit UI to convert GNO to mGNO (metaGNO for staking) and deposit to your validator.
5. [View on Explorer](/node/monitor): Wait \~1.5-2 hours for your validator(s) to go live and view at [https://beacon.gnosischain.com](https://beacon.gnosischain.com).

### Additional Software/Access Requirements

Expand Down Expand Up @@ -274,7 +274,7 @@ _`Want to learn more about Ethereum 2.0 keys and key generation?`_ 💡[Learn mo
:::note
To begin, determine which client you want to run, [Lighthouse](https://lighthouse.sigmaprime.io), [Prysm](https://prysmaticlabs.com) or [Nimbus](https://nimbus.guide/intro.html). Instructions differ for the 3 clients, **see below for instructions related to each implementation.**

Make sure your machine conforms to the [Technical Requirements](/node/consensus-layer-validator#beacon-chain-node-requirements) for running a node, including opening the following pair of ports:
Make sure your machine conforms to the [Technical Requirements](/node/requirements) for running a node, including opening the following pair of ports:

* **12000 UDP, 13000 TCP**
:::
Expand Down Expand Up @@ -339,13 +339,13 @@ A similar command can be used to look at the validator process logs: `docker-com

## Step 4) Make a Deposit

Once your node has synced (can take a few hours depending on setup) and the node and validator are running without any errors, you are ready to make a deposit. To check if your validator is synced, open the logs and you should see a message saying that the validator is awaiting activation. Making deposits is a 2 part process. See the [Validator Deposits section](/node/validator-deposits) for details.
Once your node has synced (can take a few hours depending on setup) and the node and validator are running without any errors, you are ready to make a deposit. To check if your validator is synced, open the logs and you should see a message saying that the validator is awaiting activation. Making deposits is a 2 part process. See the [Validator Deposits section](/node/deposit) for details.
##


## Connect to a Gnosis Node

If you choose not to use the public RPC and want to connect to a different Gnosis node ([including a 3rd party provider](/node/execution-layer-validator)), set `XDAI_RPC_URL`=https://\<your-endpoint>
If you choose not to use the public RPC and want to connect to a different Gnosis node ([including a 3rd party provider](/node/setup#execution-layer)), set `XDAI_RPC_URL`=https://\<your-endpoint>

:::note
If you are having issues connecting to a public RPC, you can try some of the other endpoints listed [here](/tools/rpc/).
Expand Down
2 changes: 1 addition & 1 deletion docs/node/get-started.md → docs/nodeOld/get-started.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ Validators protect Gnosis by staking on the Gnosis Beacon Chain. There are sever

## Run Your Own Node

Please view these [important notes](/node/consensus-layer-validator#before-starting) and [Technical Requirements](/node/consensus-layer-validator#beacon-chain-node-requirements) to learn more about expectations and what you will need to become a validator. Validating the GBC requires 1 [GNO](/about/tokens/gno) per validator process.
Please view these [important notes](/nodeOld/consensus-layer-validator#before-starting) and [Technical Requirements](/nodeOld/consensus-layer-validator#beacon-chain-node-requirements) to learn more about expectations and what you will need to become a validator. Validating the GBC requires 1 [GNO](/about/tokens/gno) per validator process.

:::note
DappNode now supports the Gnosis Beacon Chain! If you would like to use their services for validation, please see the [guide and instructions here](https://forum.dappnode.io/t/how-to-setup-a-gnosis-beacon-chain-gbc-validator-on-dappnode/1351)
Expand Down
36 changes: 36 additions & 0 deletions docs/nodeOld/incentives.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,36 @@
---
---

# Incentives

## Gnosis Beacon Chain Validator Rewards

The minimum requirement to run a validator is 1 [GNO](/about/tokens/gno) (staked as 32 mGNO tokens). Rewards are based on the number of validators securing the chain.

| GNO staked | % of GNO validating | reward for validators | Total GNO rewards | Overall inflation p.a. |
| ---------- | ------------------- | --------------------- | ----------------- | ---------------------- |
| 4096 | 0.23% | 83.85% | 3434.496 | 0.19% |
| 50000 | 2.78% | 23.01% | 11505 | 0.64% |
| 100000 | 5.56% | 16.65% | 16650 | 0.93% |
| 200000 | 11.11% | 11.89% | 23780 | 1.32% |
| 400000 | 22.22% | 8.45% | 33800 | 1.88% |
| 800000 | 44.44% | 5.99% | 47920 | 2.66% |
| 1800000 | 100.00% | 4.00% | 72000 | 4.00% |

:::note
[APY Calculator](https://www.desmos.com/calculator/7pzueggivw) for the rewards curve. The Y axis is APR and the X axis is the number of validators multiplied by 100.

Following parameters set for the calculation.

F: Block reward factor = 25

T: Time between blocks = 5

S: Slots in an epoch= 16

N: amount of validators required for the launch = 4096
:::

## Current Yield View

To view the current validator reward percentage and other deposit statistics, see the [Gnosis Beacon Chain Dune Analytics dashboard](https://dune.xyz/maxaleks/Gnosis-Beacon-Chain-\(Deposits\)).
File renamed without changes.
File renamed without changes.
Loading