Doc stakingv4 #482

mariusmihaic · 2022-11-09T12:15:58Z

Description of the pull request (what is new / what has changed)

Did you test the changes locally ?

yes
no

Which category (categories) does this pull request belong to?

document new feature
update documentation that is not relevant anymore
add examples or more information about a component
fix grammar issues
other

# Conflicts: # website/sidebars.json

schimih

Good text overall. I added just a few suggestions to bring some clarity...
Good job!

schimih · 2022-11-15T20:28:38Z

docs/validators/staking-v4.md

+Staking and delegation should be developed as time goes on. No system has to stay the same. Our assumptions of how the
+market works and reacts may change over time, the same way it may change with users and markets.
+Right now we have around 400 validators (running one or multiple nodes). Some of them are staking providers, while
+others are individuals running validators directly. Although most of the nodes have a nice topUp on the top of the base
+stake of 2.5k eGLD, others don't contribute to the network's security by adding more topUp.


Suggested change

Staking and delegation should be developed as time goes on. No system has to stay the same. Our assumptions of how the

market works and reacts may change over time, the same way it may change with users and markets.

Right now we have around 400 validators (running one or multiple nodes). Some of them are staking providers, while

others are individuals running validators directly. Although most of the nodes have a nice topUp on the top of the base

stake of 2.5k eGLD, others don't contribute to the network's security by adding more topUp.

Staking and delegation should be developed as time goes on. No system has to stay the same. Our assumptions of how the

the market works and reacts may change over time, the same way it may change with users and their needs.

We currently have around 400 validators (running one or multiple nodes). Some are staking providers, while others are individuals running validators directly. Although most nodes have a nice topUp on the top of the base stake of 2500 eGLD, others don't contribute to the network's security by adding more topUp.

Fixed 2.5k -> 2.500

schimih · 2022-11-15T20:34:44Z

docs/validators/staking-v4.md

+- Big providers are getting bigger, it does not help with decentralization. 31% of validators are controlled by Elrond
+  Foundation. The top 11 staking agencies control 33%.


Suggested change

- Big providers are getting bigger, it does not help with decentralization. 31% of validators are controlled by Elrond

Foundation. The top 11 staking agencies control 33%.

- Big providers are getting bigger, it does not help with decentralization. Elrond Foundation controls 31% of validators. The top 11 staking agencies control 33%.

schimih · 2022-11-15T20:47:52Z

docs/validators/staking-v4.md

+- Big providers are putting up nodes in the waiting list - as they have little to lose and when somebody gets out, they
+  are the first to enter.
+
+One of the first things we should eliminate is the additional queue and use the topUp value per node in order to decide


Suggested change

One of the first things we should eliminate is the additional queue and use the topUp value per node in order to decide

One of the first things we should eliminate is the additional queue and use the topUp value per node to decide

schimih · 2022-11-15T20:48:26Z

docs/validators/staking-v4.md

+  are the first to enter.
+
+One of the first things we should eliminate is the additional queue and use the topUp value per node in order to decide
+which are the best nodes and select those at the end of the epoch to become active. Doing that, we do not limit the


Suggested change

which are the best nodes and select those at the end of the epoch to become active. Doing that, we do not limit the

which are the best nodes and select those at the end of the epoch to become active. By doing that, we do not limit the

schimih · 2022-11-15T20:50:21Z

docs/validators/staking-v4.md

+One of the first things we should eliminate is the additional queue and use the topUp value per node in order to decide
+which are the best nodes and select those at the end of the epoch to become active. Doing that, we do not limit the
+entry of new validators as currently an old validator must leave in order for a new one to enter. The market will decide
+the actual price of the node, but it is not a hard auction, better say, it is a soft auction, where everybody paying the


Suggested change

the actual price of the node, but it is not a hard auction, better say, it is a soft auction, where everybody paying the

the actual price of the node, but it is not a hard auction; better say, it is a soft auction, where everybody paying the

schimih · 2022-11-15T21:47:29Z

docs/validators/staking-v4.md

+
+## One of my nodes was sent to auction during stakingV4 phase2. Will I loose rewards?
+
+If one of your nodes is shuffled out into auction list during phase2 it will enter in competition with the other


Suggested change

If one of your nodes is shuffled out into auction list during phase2 it will enter in competition with the other

If one of your nodes is shuffled-out into auction list during the phase2, it will compete with the other

schimih · 2022-11-15T21:48:11Z

docs/validators/staking-v4.md

+## One of my nodes was sent to auction during stakingV4 phase2. Will I loose rewards?
+
+If one of your nodes is shuffled out into auction list during phase2 it will enter in competition with the other
+existing nodes. In case you have enough topUP, **nothing changes, no rewards will be lost**. For owners that


Suggested change

existing nodes. In case you have enough topUP, **nothing changes, no rewards will be lost**. For owners that

existing nodes. If you have enough topUp, **nothing changes, and you won't lose any rewards**. THis change

schimih · 2022-11-15T21:48:54Z

docs/validators/staking-v4.md

+
+If one of your nodes is shuffled out into auction list during phase2 it will enter in competition with the other
+existing nodes. In case you have enough topUP, **nothing changes, no rewards will be lost**. For owners that
+contribute to the ecosystem and keep a nice topUp, this change will not have any negative impact. Of course, in case you


Suggested change

contribute to the ecosystem and keep a nice topUp, this change will not have any negative impact. Of course, in case you

will not negatively impact owners that contribute to the ecosystem and keep a nice topUp. Of course, if you have low topUp, or close to zero, your nodes might be unqualified and remain on the auction list.

schimih · 2022-11-15T21:49:08Z

docs/validators/staking-v4.md

+If one of your nodes is shuffled out into auction list during phase2 it will enter in competition with the other
+existing nodes. In case you have enough topUP, **nothing changes, no rewards will be lost**. For owners that
+contribute to the ecosystem and keep a nice topUp, this change will not have any negative impact. Of course, in case you
+have low topUp, or close to zero, your nodes might be unqualified and remain in auction list.


Suggested change

have low topUp, or close to zero, your nodes might be unqualified and remain in auction list.

schimih · 2022-11-15T21:50:30Z

docs/validators/staking-v4.md

+"idle"(not participating in consensus) for 5 epochs. During this time, the node would not gain any rewards.
+
+During stakingV4 phase2, no node from waiting is moved to active. If we were to keep the same configuration, a shuffled
+out node from this phase would have to wait 6 epochs until eligible(if selected from auction) and therefore decreasing


Suggested change

out node from this phase would have to wait 6 epochs until eligible(if selected from auction) and therefore decreasing

out node from this phase would have to wait for 6 epochs until eligible(if selected from auction) and therefore decreasing

# Conflicts: # website/sidebars.json

sasurobert · 2024-01-18T14:38:28Z

docs/validators/staking-v4.md

+
+- Limiting the number of nodes to 3200, creating an additional queue. New validators can join the network only if
+  someone leaves the system.
+- Concentration of power among large providers, hindering decentralization. MultiversX Foundation together with the top


I would rephrase it, say that the top X agencies control 33%.

Right, good point, rephrased it

sasurobert · 2024-01-18T14:39:13Z

docs/validators/staking-v4.md

+  someone leaves the system.
+- Concentration of power among large providers, hindering decentralization. MultiversX Foundation together with the top
+  11 staking agencies control 33%.
+- Large providers strategically place nodes in the waiting list, taking advantage of their position when a slot becomes


I think this could be deleted.

sasurobert · 2024-01-18T14:42:02Z

docs/validators/staking-v4.md

+   shard's waiting list.
+
+In the current implementation, each node, regardless of its top-up, has equal chances of participating in the consensus.
+However, starting with staking phase 4, validators with higher staked top-up will have higher chances of participation.


actually those nodes with no topup, or small topup will have really small chance to enter into validation.

Changed text to:

"Starting with staking phase 4, the probability of validators entering the validation process will be significantly influenced by the amount of their staked top-up. Validators with a higher staked top-up will have considerably greater chances of participation, while those with little or no top-up will find their chances of entering into validation markedly reduced."

sasurobert · 2024-01-18T14:43:33Z

docs/validators/staking-v4.md

+
+Staking phase 4 will unfold in three consecutive steps, each corresponding to a specific epoch.
+
+## Staking v4. Phase 1.


we named staking Phase 4. so I would change the "Phase" from this. It sounds band staking phase 4 phase 1. Just put step 1.

Right, renamed everywhere to step

sasurobert · 2024-01-18T14:44:18Z

docs/validators/staking-v4.md

+
+:::note
+
+The minimum required topUp per node, along with the real-time auction list, will be accessible in the explorer at all


is accessible.

Refactored here and in another place as well

mariusmihaic added 8 commits November 9, 2022 12:54

FEAT: Dummy version

8814fcb

Merge branch 'development' into doc-stakingv4

07521dc

# Conflicts: # website/sidebars.json

DOC: Intermediary version

9f51536

DOC: Intermediary version

4be7d51

DOC: Intermediary version

8a924ec

DOC: Intermediary version

a8544e4

DOC: Intermediary version

c536973

DOC: Intermediary version

6e95a83

mariusmihaic self-assigned this Nov 15, 2022

schimih self-requested a review November 15, 2022 15:58

schimih reviewed Nov 15, 2022

View reviewed changes

mariusmihaic added 9 commits January 10, 2024 15:55

Merge branch 'development' into doc-stakingv4

8eca709

# Conflicts: # website/sidebars.json

FIX: Add staking v4 sidebar

d685394

FIX: Move pngs

431850b

FIX: Rephrase all staking-v4.md

9dd78e0

FIX: Values in example

10eae7c

FIX: Values in example

63552e0

FIX: Values in example

9c5e84b

FAT: Add node limitation description

6cecdcc

CLN: Update pngs

8080b95

mariusmihaic marked this pull request as ready for review January 18, 2024 14:10

sasurobert approved these changes Jan 18, 2024

View reviewed changes

sasurobert requested changes Jan 18, 2024

View reviewed changes

mariusmihaic added 2 commits January 23, 2024 10:33

FIX: After review

a904f80

FIX: After review

512235b

sasurobert approved these changes Jan 23, 2024

View reviewed changes

schimih approved these changes Jan 30, 2024

View reviewed changes

mariusmihaic merged commit bb88859 into development Feb 6, 2024
1 check passed

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Doc stakingv4 #482

Doc stakingv4 #482

mariusmihaic commented Nov 9, 2022 •

edited

Loading

schimih left a comment

schimih Nov 15, 2022

mariusmihaic Jan 23, 2024

schimih Nov 15, 2022

schimih Nov 15, 2022

schimih Nov 15, 2022

schimih Nov 15, 2022

schimih Nov 15, 2022

schimih Nov 15, 2022

schimih Nov 15, 2022

schimih Nov 15, 2022

schimih Nov 15, 2022

sasurobert Jan 18, 2024

mariusmihaic Jan 23, 2024

sasurobert Jan 18, 2024

mariusmihaic Jan 23, 2024

sasurobert Jan 18, 2024

mariusmihaic Jan 23, 2024

sasurobert Jan 18, 2024

mariusmihaic Jan 23, 2024

sasurobert Jan 18, 2024

mariusmihaic Jan 23, 2024

		- Big providers are getting bigger, it does not help with decentralization. 31% of validators are controlled by Elrond
		Foundation. The top 11 staking agencies control 33%.

	One of the first things we should eliminate is the additional queue and use the topUp value per node in order to decide
	One of the first things we should eliminate is the additional queue and use the topUp value per node to decide

	which are the best nodes and select those at the end of the epoch to become active. Doing that, we do not limit the
	which are the best nodes and select those at the end of the epoch to become active. By doing that, we do not limit the

	the actual price of the node, but it is not a hard auction, better say, it is a soft auction, where everybody paying the
	the actual price of the node, but it is not a hard auction; better say, it is a soft auction, where everybody paying the


		## One of my nodes was sent to auction during stakingV4 phase2. Will I loose rewards?

		If one of your nodes is shuffled out into auction list during phase2 it will enter in competition with the other

	If one of your nodes is shuffled out into auction list during phase2 it will enter in competition with the other
	If one of your nodes is shuffled-out into auction list during the phase2, it will compete with the other

	existing nodes. In case you have enough topUP, nothing changes, no rewards will be lost. For owners that
	existing nodes. If you have enough topUp, nothing changes, and you won't lose any rewards. THis change

	contribute to the ecosystem and keep a nice topUp, this change will not have any negative impact. Of course, in case you
	will not negatively impact owners that contribute to the ecosystem and keep a nice topUp. Of course, if you have low topUp, or close to zero, your nodes might be unqualified and remain on the auction list.

	out node from this phase would have to wait 6 epochs until eligible(if selected from auction) and therefore decreasing
	out node from this phase would have to wait for 6 epochs until eligible(if selected from auction) and therefore decreasing


		Staking phase 4 will unfold in three consecutive steps, each corresponding to a specific epoch.

		## Staking v4. Phase 1.


		:::note

		The minimum required topUp per node, along with the real-time auction list, will be accessible in the explorer at all

Doc stakingv4 #482

Doc stakingv4 #482

Conversation

mariusmihaic commented Nov 9, 2022 • edited Loading

Description of the pull request (what is new / what has changed)

Did you test the changes locally ?

Which category (categories) does this pull request belong to?

schimih left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

mariusmihaic commented Nov 9, 2022 •

edited

Loading