Skip to content

Commit

Permalink
docs: outline requirement of stake in order to vote (#33842)
Browse files Browse the repository at this point in the history
* docs: outline requirement of stake in order to vote

* pr feedback: move stake section up
  • Loading branch information
AshwinSekar authored Oct 25, 2023
1 parent 9ffbe2a commit a3b0348
Show file tree
Hide file tree
Showing 2 changed files with 26 additions and 18 deletions.
38 changes: 20 additions & 18 deletions docs/src/running-validator/validator-stake.md
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down Expand 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
Expand All @@ -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)
Expand Down
6 changes: 6 additions & 0 deletions docs/src/running-validator/validator-start.md
Original file line number Diff line number Diff line change
Expand Up @@ -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>`
Expand Down

0 comments on commit a3b0348

Please sign in to comment.