blockworks-foundation
/
solana
mirror of https://github.com/blockworks-foundation/solana.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

docs: outline requirement of stake in order to vote (#33842) 

* docs: outline requirement of stake in order to vote

* pr feedback: move stake section up
This commit is contained in:
Ashwin Sekar 2023-10-25 00:45:07 -04:00 committed by GitHub
parent 9ffbe2afd8
commit a3b0348649
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
2 changed files with 26 additions and 18 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

38
docs/src/running-validator/validator-stake.md
View File

@ -3,7 +3,7 @@ title: Staking
---
**By default your validator will have no stake.** This means it will be
ineligible to become leader.
ineligible to become leader, and unable to land votes.
## Monitoring Catch Up
@ -55,8 +55,25 @@ but only one re-delegation is permitted per epoch:
solana delegate-stake ~/validator-stake-keypair.json ~/some-other-vote-account-keypair.json
```
Assuming the node is voting, now you're up and running and generating validator
rewards. Rewards are paid automatically on epoch boundaries.
## Validator Stake Warm-up
To combat various attacks on consensus, new stake delegations are subject to
a [warm-up](/staking/stake-accounts#delegation-warmup-and-cooldown)
period.
Monitor a validator's stake during warmup by:
- View your vote account:`solana vote-account ~/vote-account-keypair.json` This displays the current state of all the votes the validator has submitted to the network.
- View your stake account, the delegation preference and details of your stake:`solana stake-account ~/validator-stake-keypair.json`
- `solana validators` displays the current active stake of all validators, including yours
- `solana stake-history` shows the history of stake warming up and cooling down over recent epochs
- Look for log messages on your validator indicating your next leader slot: `[2019-09-27T20:16:00.319721164Z INFO solana_core::replay_stage] <VALIDATOR_IDENTITY_PUBKEY> voted and reset PoH at tick height ####. My next leader slot is ####`
- Once your stake is warmed up, you will see a stake balance listed for your validator by running `solana validators`
## Validator Rewards
Once your stake is warmed up, and assuming the node is voting, you will now be
generating validator rewards. Rewards are paid automatically on epoch boundaries.
The rewards lamports earned are split between your stake account and the vote
account according to the commission rate set in the vote account. Rewards can
@ -76,21 +93,6 @@ before submitting a transaction.
Learn more about [transaction fees here](../implemented-proposals/transaction-fees.md).
## Validator Stake Warm-up
To combat various attacks on consensus, new stake delegations are subject to
a [warm-up](/staking/stake-accounts#delegation-warmup-and-cooldown)
period.
Monitor a validator's stake during warmup by:
- View your vote account:`solana vote-account ~/vote-account-keypair.json` This displays the current state of all the votes the validator has submitted to the network.
- View your stake account, the delegation preference and details of your stake:`solana stake-account ~/validator-stake-keypair.json`
- `solana validators` displays the current active stake of all validators, including yours
- `solana stake-history` shows the history of stake warming up and cooling down over recent epochs
- Look for log messages on your validator indicating your next leader slot: `[2019-09-27T20:16:00.319721164Z INFO solana_core::replay_stage] <VALIDATOR_IDENTITY_PUBKEY> voted and reset PoH at tick height ####. My next leader slot is ####`
- Once your stake is warmed up, you will see a stake balance listed for your validator by running `solana validators`
## Monitor Your Staked Validator
Confirm your validator becomes a [leader](../terminology.md#leader)

6
docs/src/running-validator/validator-start.md
View File

@ -255,6 +255,12 @@ Remember to move your authorized withdrawer keypair into a very secure location
Read more about [creating and managing a vote account](vote-accounts.md).
## Stake your validator
Until your validator is staked, it will be unable to vote, propose leader blocks, or collect rewards.
Follow the instructions to [stake your validator](validator-stake.md)
## Known validators
If you know and respect other validator operators, you can specify this on the command line with the `--known-validator <PUBKEY>`