Skip to content

Commit 1cd1332

Browse files
werner-stacksgitbook-bot
authored andcommitted
GITBOOK-99: 50,000 STX: yield distribution, not signer set (Staking, Signing, Block Production, Glossary)
1 parent 8e2c381 commit 1cd1332

4 files changed

Lines changed: 8 additions & 8 deletions

File tree

‎docs/learn/bitcoin-staking/glossary.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -97,7 +97,7 @@ A contract that every staker delegates to, bond or STX-only. It owns approval lo
9797

9898
## Signer set minimum
9999

100-
`SIGNER_SET_MIN_USTX u50000000000` is 50,000 STX. It is an aggregate threshold on total uSTX delegated to a signer, counting both bond STX and STX-only STX, with no per-staker minimum. A signer crossing it is added to that cycle's signer set; falling below removes them.
100+
`SIGNER_SET_MIN_USTX u50000000000` is 50,000 STX. It is an aggregate threshold on total uSTX delegated to a signer, counting both bond STX and STX-only STX, with no per-staker minimum. A signer at or above it gets a yield distribution for that cycle; falling below stops it.
101101

102102
## Early exit
103103

‎docs/learn/block-production/README.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -43,4 +43,4 @@ As you read through the Staking section, you may find stakers and signers mentio
4343
* Stakers are not signers\
4444
→ 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
4545
* 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
46+
→ a signer-manager with at least 50,000 STX staked to it in aggregate gets a yield distribution, and its weight grows with the stake it represents

‎docs/learn/block-production/signing.md‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@ description: >-
1818
#### The Big Picture
1919

2020
* Signers validate and sign proposed Stacks blocks before they can join the chain.
21-
* The signer set is fixed each reward cycle: every signer-manager with at least 50,000 STX staked to it.
21+
* The signer set is fixed each reward cycle. Every signer-manager with at least 50,000 STX staked to it gets a yield distribution.
2222
* A signer's voting weight is proportional to the STX staked through it.
2323
* Accepting a block requires signatures carrying at least 70% of total signer weight.
2424
* Signing prevents forks and anchors Stacks history to Bitcoin.
@@ -44,7 +44,7 @@ This behavior prevents forks. If a miner builds a block atop a stale tip, signer
4444

4545
Under PoX-5, a signer is a signer-manager contract bound to one signer key. The binding happens once: the signer-key holder signs a [SIP-018](https://github.com/stacksgov/sips/blob/main/sips/sip-018/sip-018-signed-structured-data.md) grant naming the manager, and the manager submits it through `grant-signer-key` and registers with `register-signer`. The key holder can revoke the grant at any time with `revoke-signer-grant`, which stops the manager accepting new stake while existing positions wind down.
4646

47-
During each prepare phase, the last 100 Bitcoin blocks of a reward cycle, the signer set for the upcoming cycle is fixed: every registered signer-manager with at least 50,000 STX (`SIGNER_SET_MIN_USTX`) staked to it in aggregate. A signer's voting weight for that cycle is proportional to the total STX staked through it, counting the STX in STX-only stakes and the STX side of protocol bonds together. The BTC side of a bond carries no signing weight: signing weight, like governance weight, is a function of locked STX alone.
47+
During each prepare phase, the last 100 Bitcoin blocks of a reward cycle, the signer set for the upcoming cycle is fixed. Every registered signer-manager with at least 50,000 STX (`SIGNER_SET_MIN_USTX`) staked to it in aggregate gets a yield distribution. A signer's voting weight for that cycle is proportional to the total STX staked through it, counting the STX in STX-only stakes and the STX side of protocol bonds together. The BTC side of a bond carries no signing weight: signing weight, like governance weight, is a function of locked STX alone.
4848

4949
The signer software detects from chain state whether its manager is in the upcoming cycle's signer set. Staking transactions are sent manually; everything the signer does with that information is automatic.
5050

@@ -53,7 +53,7 @@ The signer software detects from chain state whether its manager is in the upcom
5353
<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%2FS1L4pYrXDd1Ju74JhJkr%2Fstaking-and-signing.png?alt=media&#x26;token=3395cd31-c1fa-4f1a-97e0-f762285052c7" alt="Manual staking transactions feeding the reward phase, and the signer software acting automatically once its manager is in the signer set"><figcaption><p>Manual on the staker's side, automatic on the signer's</p></figcaption></figure></div>
5454

5555
* Stakers are not signers. Signing is done by the key granted to the signer-manager they stake to, and running that signer is the manager operator's job.
56-
* Every signer is backed by staked STX. To be in the signer set, a manager must represent at least the 50,000 STX aggregate threshold, and its weight grows with the stake it represents.
56+
* Every signer is backed by staked STX. A manager with at least the 50,000 STX aggregate threshold gets a yield distribution, and its weight grows with the stake it represents.
5757

5858
***
5959

‎docs/learn/block-production/staking.md‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ description: >-
2020
* Staking locks STX to help secure the network and earn Bitcoin-denominated rewards.
2121
* It is part of Proof of Transfer (PoX): miners commit BTC, and that BTC pays stakers.
2222
* You stake by naming a signer-manager contract. The STX locks in your own account and never moves.
23-
* There is no per-staker minimum. A signer-manager needs 50,000 STX in aggregate to enter the signer set.
23+
* There is no per-staker minimum. A signer-manager with at least 50,000 STX staked to it in aggregate gets a yield distribution.
2424
* You can unstake an STX-only position at any time, and the STX unlocks at the start of the next cycle. Bond-paired STX is committed for the bond term.
2525
* Rewards arrive as sBTC by default. A native BTC payout can be elected through your signer-manager.
2626

@@ -74,7 +74,7 @@ Who does what:
7474
* **The signer-manager contract** is bound to a signer key once, through a one-time [SIP-018](https://github.com/stacksgov/sips/blob/main/sips/sip-018/sip-018-signed-structured-data.md) grant, and receives your settled rewards for onward distribution. It may take a fee, which is contract-level logic rather than a protocol feature.
7575
* **The pox-5 contract** registers your position for every cycle you chose in the single staking transaction, and settles rewards per staker to the manager.
7676

77-
A signer-manager enters the signer set once at least 50,000 STX (`SIGNER_SET_MIN_USTX`) is staked to it in aggregate. The threshold is fixed, and it applies to the manager rather than to you: your own stake can be any size.
77+
A signer-manager with at least 50,000 STX (`SIGNER_SET_MIN_USTX`) staked to it in aggregate gets a yield distribution. The threshold is fixed, and it applies to the manager rather than to you: your own stake can be any size.
7878

7979
Running your own signer-manager and staking to someone else's are the same mechanism. A "solo" staker is someone running their own manager, which is operationally identical to offering a pool, because anyone can stake to that contract.
8080

@@ -154,7 +154,7 @@ Staking happens in reward cycles of 2,100 Bitcoin blocks (roughly two weeks). Th
154154

155155
<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%2Ffz7B1xYNMnl5u5ICddZi%2Fstaking-cycles.png?alt=media&#x26;token=7aea0cf7-4dee-42af-a195-acf5c9aade65" alt="A reward cycle of 2,100 Bitcoin blocks ending in a 100-block prepare phase, with reward distributions every 1,050 blocks and unlocks at the cycle boundary"><figcaption><p>One reward cycle, block by block</p></figcaption></figure></div>
156156

157-
* The prepare phase fixes the signer set for the upcoming cycle: every signer-manager with at least 50,000 STX staked to it in aggregate.
157+
* The prepare phase fixes the signer set for the upcoming cycle. Every signer-manager with at least 50,000 STX staked to it in aggregate gets a yield distribution.
158158
* During the reward phase, miners commit BTC to mine Stacks blocks, and that BTC funds staker rewards.
159159
* Rewards are credited once per distribution interval of 1,050 Bitcoin blocks (roughly one week), two intervals per reward cycle. The interval gates crediting only: your signer-manager can claim credited rewards at any time.
160160
* Unlocks happen at a cycle boundary: at the start of the cycle after your chosen duration ends, or after you unstake.

0 commit comments

Comments
 (0)