Skip to content

Commit cf9253c

Browse files
werner-stacksgitbook-bot
authored andcommitted
GITBOOK-70: Learn: rewrite the Block Production index for PoX-5
1 parent 7fc83b9 commit cf9253c

1 file changed

Lines changed: 17 additions & 13 deletions

File tree

Lines changed: 17 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Block Production
22

3-
<div data-with-frame="true"><figure><img src="../.gitbook/assets/block-production-cover.png" alt=""><figcaption></figcaption></figure></div>
3+
<div data-with-frame="true"><figure><img src="https://2842511454-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FH74xqoobupBWwBsVMJhK%2Fuploads%2FAtIlPCw7qrGfrokaExNi%2Fblock-production-cover.png?alt=media&#x26;token=a3179850-9434-42ed-baf4-c64037aa5b03" alt=""><figcaption></figcaption></figure></div>
44

55
Block production is a key concept to understand how Stacks operates under the hood. This section walks through the three main actions that need to happen for the Stacks network to operate.
66

@@ -14,29 +14,33 @@ Miners are responsible for building and proposing new blocks on the Stacks chain
1414
{% step %}
1515
**Signing**
1616

17-
Signing is the process used to validate blocks and sign sBTC deposits and withdrawals. Stackers participate in signing once they meet stacking prerequisites.
17+
Signing is the process used to validate blocks before they join the chain. A signer is a signer-manager contract bound to one signer key, and a block joins the chain only once signers carrying enough weight have signed it.
1818
{% endstep %}
1919

2020
{% step %}
21-
**Stacking**
21+
**Staking**
2222

23-
Stacking is an action performed by stackers that is a necessary prerequisite to signing. It enables participation in validation and earning rewards.
23+
Staking is where that weight comes from. You lock STX in your own account and name an existing signer-manager contract; the stake you add becomes part of that manager's weight, and you earn Bitcoin-denominated rewards for it. Staking takes one of two mutually exclusive paths per account: STX-only, or a protocol bond pairing native BTC or sBTC with an STX lock.
2424
{% endstep %}
2525
{% endstepper %}
2626

27-
There are two primary parties in Stacks block production: miners, stackers, and signers. Miners build and propose new blocks, while stackers validate those blocks and sign sBTC deposits and withdrawals. Stacking enables stackers to participate in signing.
27+
Three roles cooperate in Stacks block production: miners build and propose new blocks, signers validate and sign them, and stakers back the signers by locking STX to a signer-manager.
28+
29+
{% hint style="info" %}
30+
**Signers here are not sBTC signers.** The signers on this page validate Stacks blocks under PoX-5. The [sBTC signers](https://docs.stacks.co/learn/sbtc/clarity-contracts/sbtc-signers) are a separate set with their own keys in their own contract, and they do not have to be Stacks signers. Their threshold signing requires more than 50% of the signer keys. The one connection is that the sBTC bridge is how miner-committed BTC becomes the sBTC paid out as staking rewards.
31+
{% endhint %}
2832

2933
***
3034

31-
### Core Roles: Miner vs Stacker vs Signer
35+
### Core Roles: Miner vs Staker vs Signer
3236

33-
<table><thead><tr><th width="94.29296875">Role</th><th>Primary Function</th><th>What They Do</th><th>Rewards</th><th>Where They Operate</th></tr></thead><tbody><tr><td><strong>Miner</strong></td><td>Produce Stacks blocks</td><td>Sends BTC in PoX to compete for the right to write the next block and earn STX</td><td>Earns STX block rewards + fees</td><td>Bitcoin (for bids) + Stacks</td></tr><tr><td><strong>Stacker</strong></td><td>Secure the network via PoX</td><td>Locks STX and signals support for consensus</td><td>Earns BTC from miners</td><td>Stacks (locks STX), rewards on Bitcoin</td></tr><tr><td><strong>Signer</strong></td><td>Validate and finalize blocks</td><td>Participates in block signing to confirm canonical chain state; defines reward set</td><td>Rewards based on custom agreements with Stackers</td><td>Stacks</td></tr></tbody></table>
37+
<table><thead><tr><th width="94.29296875">Role</th><th>Primary Function</th><th>What They Do</th><th>Rewards</th><th>Where They Operate</th></tr></thead><tbody><tr><td><strong>Miner</strong></td><td>Produce Stacks blocks</td><td>Sends BTC in PoX to compete for the right to write the next block and earn STX</td><td>Earns STX block rewards + fees</td><td>Bitcoin (for bids) + Stacks</td></tr><tr><td><strong>Staker</strong></td><td>Secure the network via PoX</td><td>Locks STX in their own account and names a signer-manager contract</td><td>Earns Bitcoin-denominated rewards funded by miner BTC, as sBTC by default or native BTC by election</td><td>Stacks (the STX never leaves their account)</td></tr><tr><td><strong>Signer</strong></td><td>Validate and finalize blocks</td><td>A signer-manager contract bound to one signer key signs blocks; its weight is proportional to the STX staked through it</td><td>Receives per-staker settled rewards from pox-5 for distribution, and may take a fee set in the contract</td><td>Stacks</td></tr></tbody></table>
3438

35-
#### The relationship between Stackers and Signers
39+
#### The relationship between Stakers and Signers
3640

37-
As you read through the Stacking section, you may find that Stackers are interchangeably referred to as Signers. It's true that Stackers can also take on the role of a Signer, and vice versa, but there's some nuances to it that need to be understood:
41+
As you read through the Staking section, you may find stakers and signers mentioned in the same breath. Under PoX-5 the relationship is precise:
3842

39-
* Not all stackers are signers\
40-
→ because stackers can **delegate** their participation (including signing responsibilities)
41-
* All signers are backed by **their own STX** or **delegated STX**\
42-
→ to be in the signer set, you must represent **stacked STX weight**
43+
* Stakers are not signers\
44+
→ signing is done by the key granted to the signer-manager contract they stake to, and running that signer is the manager operator's job
45+
* Every signer is backed by **staked STX**\
46+
→ to be in the signer set, a signer-manager must have at least 50,000 STX staked to it in aggregate, and its weight grows with the stake it represents

0 commit comments

Comments
 (0)