Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
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
2 changes: 1 addition & 1 deletion docs/learn/baking/bakeordelegate.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ hide_title: true

### Should I bake or delegate? <a id="bakeordelegate"></a>

Self-baking lets a baker earn a higher yield, but requires technical expertise and time in setting up a baker and running the baking software reliably with as little downtime as possible. By delegating Tezos tokens, a token holder avoids this process altogether but usually earns a lower yield. In the current protocol, token holders with less than 8,000 XTZ can only participate in baking by delegating to another baker.
Self-baking lets a baker earn a higher yield, but requires technical expertise and time in setting up a baker and running the baking software reliably with as little downtime as possible. By delegating Tezos tokens, a token holder avoids this process altogether but usually earns a lower yield. In the current protocol, token holders with less than 6,000 XTZ can only participate in baking by delegating to another baker.

### How much can I earn by baking or delegating? <a id="earn"></a>

Expand Down
4 changes: 2 additions & 2 deletions docs/learn/baking/intro.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,9 +13,9 @@ sidebar_position: 1

“Baking” is the act of signing and publishing blocks to the Tezos blockchain. Bakers are a crucial component of the Proof-of-Stake consensus mechanism by ensuring that all transactions in a block are correct, that the order of transactions is agreed upon, and that no double-spending has occurred.

To bake blocks, a baker needs to participate in Proof-of-Stake, which requires a minimum of 8,000 XTZ \(1 roll\). The more rolls of tez that a baker owns, the higher your chances are at baking blocks and earning baking rewards.
To bake blocks, a baker needs to participate in Proof-of-Stake, which requires a minimum of 6,000 XTZ \(1 roll\). The more rolls of tez that a baker owns, the higher your chances are at baking blocks and earning baking rewards.

### What is delegating?

If someone does not have 8,000 XTZ or does not want to set up computing infrastructure to bake blocks, they may delegate their coins to a baker \(aka "delegate"\). Delegating lets coin holders \(i.e. "delegators"\) "lend" their coins to a baker \(i.e. a "delegate"\), giving the baker a higher probability of being selected to bake and endorse blocks. In practice, bakers usually share the additional revenue generated from the delegated tokens with the coin holder. Importantly, this process does not actually transfer ownership of coins and hence the baker cannot spend or control the XTZ delegated to it, ensuring that bakers cannot appropriate the delegators' funds.
If someone does not have 6,000 XTZ or does not want to set up computing infrastructure to bake blocks, they may delegate their coins to a baker \(aka "delegate"\). Delegating lets coin holders \(i.e. "delegators"\) "lend" their coins to a baker \(i.e. a "delegate"\), giving the baker a higher probability of being selected to bake and endorse blocks. In practice, bakers usually share the additional revenue generated from the delegated tokens with the coin holder. Importantly, this process does not actually transfer ownership of coins and hence the baker cannot spend or control the XTZ delegated to it, ensuring that bakers cannot appropriate the delegators' funds.

6 changes: 3 additions & 3 deletions docs/learn/baking/proofofstake/consensus.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ Tezos uses a Nakamoto-style PoS algorithm for consensus, which since [Babylon](h

1. **Block Creation \(Baking\)**

Block creation is the way that the blockchain makes progress. In Tezos, participants who create blocks are called _bakers_. To be considered a baker, a participant needs to own at least 8,000 ꜩ \(1 roll\). The more rolls someone has, the higher their chance of being given the rights to bake the next block. If there are 10 rolls activated at some point in time, and a baker owns 2/10 of those rolls, they have a 20% chance of being given the rights to create the next block. This means that if a baker has 8,000 ꜩ or 15,999 ꜩ, they have the same baking rights in the system.
Block creation is the way that the blockchain makes progress. In Tezos, participants who create blocks are called _bakers_. To be considered a baker, a participant needs to own at least 6,000 ꜩ \(1 roll\). The more rolls someone has, the higher their chance of being given the rights to bake the next block. If there are 10 rolls activated at some point in time, and a baker owns 2/10 of those rolls, they have a 20% chance of being given the rights to create the next block. This means that if a baker has 6,000 ꜩ or 15,999 ꜩ, they have the same baking rights in the system.

Baking rights are set in terms of priorities. For example, if there are 10 rolls, the protocol could randomly select a priority list as follows:

Expand Down Expand Up @@ -49,13 +49,13 @@ Tezos uses a Nakamoto-style PoS algorithm for consensus, which since [Babylon](h

### Delegation <a id="delegation"></a>

If someone does not have 8,000 ꜩ or does not want to set up computing infrastructure to bake blocks, they can delegate their coins to a baker. Delegating lets coin holders "lend" their coins to a baker. As a result, the baker has a higher probability of being selected, and the baker in turn shares the additional revenue with the coin holder. Importantly, this process does not actually transfer ownership of coins. The baker cannot spend the ꜩ delegated to them, and bakers cannot run away with other people's money.
If someone does not have 6,000 ꜩ or does not want to set up computing infrastructure to bake blocks, they can delegate their coins to a baker. Delegating lets coin holders "lend" their coins to a baker. As a result, the baker has a higher probability of being selected, and the baker in turn shares the additional revenue with the coin holder. Importantly, this process does not actually transfer ownership of coins. The baker cannot spend the ꜩ delegated to them, and bakers cannot run away with other people's money.

Groups have sprung up offering competitive rates for their baking services, and most charge ~10-20% fees on the rewards that people obtain by delegating to them.

This use of delegation is the reason many people refer to Tezos as a [Liquid Proof-of-Stake](https://medium.com/tezos/liquid-proof-of-stake-aec2f7ef1da7) system.

**To summarize:** The Tezos consensus protocol called Emmy+ is a Nakamoto-style Liquid PoS consensus algorithm. Delegates \(people who have at least 8,000 ꜩ of delegated funds\) are given the responsibility of creating and endorsing blocks. They are rewarded for their action. They are also required to stake some of their own capital in order to ensure honest behavior.
**To summarize:** The Tezos consensus protocol called Emmy+ is a Nakamoto-style Liquid PoS consensus algorithm. Delegates \(people who have at least 6,000 ꜩ of delegated funds\) are given the responsibility of creating and endorsing blocks. They are rewarded for their action. They are also required to stake some of their own capital in order to ensure honest behavior.

### Finality in Tezos <a id="finality"></a>

Expand Down
2 changes: 1 addition & 1 deletion docs/learn/governance/past-tezos-amendments.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ hide_title: true

Athens was the first proposed protocol amendment for Tezos. Two proposals - “[Athens A](https://forum.tezosagora.org/t/athens-a-pt24m4xip/29)” and “[Athens B](https://forum.tezosagora.org/t/athens-b-psd1ynubh/33)” were injected by the development team, [Nomadic Labs](https://blog.nomadic-labs.com/athens-our-proposals-for-the-first-voted-amendment.html) in February 2019.

Of the two proposals, Athens A sought to increase the gas limit and reduce the roll size required to bake from 10,000 tez to 8,000 tez. Athens B sought to just increase the gas limit. Athens A was autonomously [activated](https://twitter.com/TezosAgoraBot/status/1133901612790034432?s=20) onto the protocol in May 2019.
Of the two proposals, Athens A sought to increase the gas limit and reduce the roll size required to bake from 10,000 tez to 6,000 tez. Athens B sought to just increase the gas limit. Athens A was autonomously [activated](https://twitter.com/TezosAgoraBot/status/1133901612790034432?s=20) onto the protocol in May 2019.

For a full list of changes be sure to read the corresponding blog [post](https://blog.nomadic-labs.com/athens-proposals-injected.html) from Nomadic Labs and [reflection](https://medium.com/tqtezos/reflecting-on-athens-the-first-self-amendment-of-tezos-4791ab3b1de1) by Jacob Arluck.

Expand Down
6 changes: 3 additions & 3 deletions docs/learn/governance/tezos-governance-overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,17 +16,17 @@ Tezos also allows stakeholders to upgrade the amendment process itself. As a res

#### Voters / Bakers <a id="voters--bakers"></a>

Baking is how blocks are produced and validated on a Tezos blockchain using Liquid Proof-of-Stake. Bakers \(also known as "delegates"\) obtain the right to create \(i.e. bake\) a block when a roll of tokens \(1 roll = 8,000 ꜩ\) they own \(or that is delegated to them\) is randomly selected to produce or validate a block.
Baking is how blocks are produced and validated on a Tezos blockchain using Liquid Proof-of-Stake. Bakers \(also known as "delegates"\) obtain the right to create \(i.e. bake\) a block when a roll of tokens \(1 roll = 6,000 ꜩ\) they own \(or that is delegated to them\) is randomly selected to produce or validate a block.

As the maintainers of a Tezos network, **bakers are also the voters in a Tezos formal upgrade process**, with their votes proportional to the size of their stake \(including delegations\).

#### Votes / Rolls <a id="votes--rolls"></a>

To speed up computations for deciding which delegates are selected to bake, the Tezos ledger tracks tokens for staking and governance purposes as "rolls". Rolls are aggregated at the delegate level, which means a baker’s baking power is proportional to the amount of tokens delegated to them, rounded down to the nearest roll. A roll is currently set to 8,000 ꜩ.
To speed up computations for deciding which delegates are selected to bake, the Tezos ledger tracks tokens for staking and governance purposes as "rolls". Rolls are aggregated at the delegate level, which means a baker’s baking power is proportional to the amount of tokens delegated to them, rounded down to the nearest roll. A roll is currently set to 6,000 ꜩ.

#### Delegators <a id="delegators"></a>

If someone does not have 8,000 ꜩ or does not want to set up computing infrastructure to bake blocks, they may delegate their tokens to a baker. The baker does not own or control the delegated tokens in any way. In particular, it cannot spend them. However, if and when one of these tokens is randomly selected to bake a block, that right will belong to the baker. In practice, bakers usually share the additional revenue generated from the delegated tokens with the coin holder.
If someone does not have 6,000 ꜩ or does not want to set up computing infrastructure to bake blocks, they may delegate their tokens to a baker. The baker does not own or control the delegated tokens in any way. In particular, it cannot spend them. However, if and when one of these tokens is randomly selected to bake a block, that right will belong to the baker. In practice, bakers usually share the additional revenue generated from the delegated tokens with the coin holder.

#### The Five Stages of Tezos Governance <a id="the-five-stages-of-tezos-governance"></a>

Expand Down
2 changes: 1 addition & 1 deletion docs/learn/uses-of-tezos/corporate-baking.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ hide_title: true

### Introduction to Corporate Baking

Baking within Tezos refers to the act of producing and validating new blocks for the Tezos network. Under Tezos’ Liquid Proof of Stake \(LPoS\) design, stakeholders retain the ability to either bake on their own or delegate to a bakery, who will charge a fee for their services. In order for a stakeholder to begin baking on their own, they must hold at a minimum 8,000 tez, following the passing of the Athens protocol upgrade in 2019.
Baking within Tezos refers to the act of producing and validating new blocks for the Tezos network. Under Tezos’ Liquid Proof of Stake \(LPoS\) design, stakeholders retain the ability to either bake on their own or delegate to a bakery, who will charge a fee for their services. In order for a stakeholder to begin baking on their own, they must hold at a minimum 6,000 tez, following the passing of the Athens protocol upgrade in 2019.

This design is referred to as being ‘liquid’ not only in the sense that there are no fixed set of validators producing and validating blocks on the network, as in a Delegated Proof of Stake \(DPoS\) design, but, stakeholders have the additional ability to bake on their own \(PoS\) and their delegated stake is never locked, it remains ‘liquid’ and free to move.

Expand Down
2 changes: 1 addition & 1 deletion docs/use/baking/setting-up-a-secure-baker.md
Original file line number Diff line number Diff line change
Expand Up @@ -118,7 +118,7 @@ The keys are stored in the directory ./tezos-client in your home directory. This

**Let’s start Baking!**

The first step is to activate the account for baking so that you start to get baking and endorsement rights. It will take at least 2 cycles before you get rights in a snapshot and 5 cycles before you start to bake \(a cycle is just under 3 days\). So once you have activated, you won’t need to start your baker and endorsement processes for 21 days although it doesn’t matter if you start them straight away so they are ready to go. You also need to fund your baking address with at least 1 roll \(1 roll = 8,000 tez\); you don’t want to miss your first block or endorsement!
The first step is to activate the account for baking so that you start to get baking and endorsement rights. It will take at least 2 cycles before you get rights in a snapshot and 5 cycles before you start to bake \(a cycle is just under 3 days\). So once you have activated, you won’t need to start your baker and endorsement processes for 21 days although it doesn’t matter if you start them straight away so they are ready to go. You also need to fund your baking address with at least 1 roll \(1 roll = 6,000 tez\); you don’t want to miss your first block or endorsement!

`./tezos-client register key <baking_address> as delegate`

Expand Down