Skip to content

Commit c037690

Browse files
committed
feat: update docs
1 parent e07822f commit c037690

File tree

4 files changed

+19
-10
lines changed

4 files changed

+19
-10
lines changed

docs/build/nodes/collator/learn.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -43,7 +43,7 @@ A collator (block producer) is rewarded a fixed amount for each block produced.
4343

4444
## Collator election mechanism
4545
### Election process
46-
To join the election process you must register for a collator and bond tokens, see [Collator Requirements](https://docs.astar.network/docs/build/nodes/collator/requirements) for details. When your node fits the parameters and checks all the boxes to become a collator, it will be added to the chain. **Note: if your collator doesn’t produce blocks during two sessions (2h) it will be kicked out.**
46+
To join the election process you must apply for a collator candidacy and bond tokens, then ask for approval from governance (2/3 MainCouncil or referendum), see [Collator Requirements](https://docs.astar.network/docs/build/nodes/collator/requirements) for details. When your node fits the parameters and checks all the boxes to become a collator, it will be added to the chain. **Note: if your collator doesn’t produce blocks during two sessions (2h) it will be kicked out.**
4747

4848
---
4949

@@ -56,6 +56,8 @@ At every block you produced as a collator, rewards will automatically be transfe
5656
Starting April 2022, a slashing mechanism is implemented on Astar and Shiden networks - a collator that doesn't produce blocks during two sessions (2 hours) will be slashed 1% of its total stake and kicked out of the active collator set.
5757
This slashing ensures the best block rate and prevents malicious actors from harming the network without financial consequences.
5858

59+
Additionally, collators can be forced slashed by governance (3/4 MainCouncil or Referendum)
60+
5961
---
6062

6163
## FAQ

docs/build/nodes/collator/requirements.md

Lines changed: 7 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -9,9 +9,12 @@ import TabItem from '@theme/TabItem';
99

1010
## How to become a collator
1111

12-
### Permissionless collator
12+
### Semi-Permissionless collator
1313

14-
To become a permissionless collator on our networks, you need to meet the requirements below.
14+
To become a collator on our networks, you need to be approved by governance (2/3 MainCouncil or referendum).
15+
1. Apply for candidacy by reserving the bond (**Extrinsics - CollatorSelection - Apply for candidacy**)
16+
2. Request for approval from governance.
17+
3. Once governance proposal is executed (**Extrinsics - CollatorSelection - Approve application**). The onboading takes **n+1** session.
1518

1619
**Collator staking requirements**
1720

@@ -39,9 +42,8 @@ To become a permissionless collator on our networks, you need to meet the requir
3942
</Tabs>
4043

4144
:::tip
42-
Set your collator with:
43-
**Extrinsics - CollatorSelection - Register as candidate** |
44-
Onboarding takes **n+1** session.
45+
If you want to withdraw the application and unlock the bond
46+
**Extrinsics - CollatorSelection - Close Application**
4547
:::
4648

4749
---

docs/build/nodes/collator/spinup_collator.md

Lines changed: 9 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -132,20 +132,24 @@ Select your **collator account** and extrinsic type: _**identity / requestJudgme
132132

133133
Send the transaction.
134134

135-
### Bond funds
135+
### Bond funds and apply for candidacy
136136

137-
To start collating, you need to have **32 000 SDN** tokens for Shiden or **3 200 000 ASTR** tokens for Astar.
137+
To apply collator candidacy, you need to have **32 000 SDN** tokens for Shiden or **3 200 000 ASTR** tokens for Astar.
138138

139139
On the Polkadot.js portal select _**Developer > Extrinsic**_.
140140

141-
Select your **collator account** and extrinsic type: _**CollatorSelection / registerAsCandidate**_:
141+
Select your **collator account** and extrinsic type: _**CollatorSelection / applyForCandidacy()**_:
142142

143143
<center>
144-
<img src="https://i.imgur.com/3YvdJbt.png" border="1"></img>
144+
<img src="/img/tutorial/apply_for_collator.png" border="1"></img>
145145
</center>
146146

147147
Submit the transaction.
148148

149+
### Request for approval from governance
150+
151+
Create a forum post and initiate a gov proposal - TODO (TBD)
152+
149153
### Production blocks
150154

151155
:::info
@@ -165,6 +169,7 @@ Once you become a collator and enter a session, you are required to produce bloc
165169
On the Polkadot.js portal select _**Developer > Extrinsic**_.
166170

167171
Select your **collator account** and extrinsic type: _**CollatorSelection / leaveIntent**_:
172+
168173
<center>
169174
<img src="/img/tutorial/collator-selection-leave-intent.png" border="1"></img>
170175
</center>
288 KB
Loading

0 commit comments

Comments
 (0)