Skip to content

Commit 7607eea

Browse files
committed
docs: update validator page with PIP-49 delegation fields
- Fix 'Last Joined Height' to 'Last Sortition Height' per source code - Add optional delegation fields from PIP-49 (DelegateOwner, DelegateShare, DelegateExpiry) - Update structure size: 120 bytes base, 153 bytes with delegation
1 parent ab8580d commit 7607eea

1 file changed

Lines changed: 29 additions & 12 deletions

File tree

content/protocol/blockchain/validator.md

Lines changed: 29 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -10,21 +10,38 @@ The amount of stake held by validators determines their power in the consensus.
1010

1111
## Validator Structure
1212

13-
The Validator structure is 120 bytes long and consists of the following fields:
13+
The base Validator structure is 120 bytes long and consists of the following fields:
1414

15-
| Field | Size |
16-
| ------------------- | -------- |
17-
| Public Key | 96 bytes |
18-
| Number | 4 bytes |
19-
| Stake | 8 bytes |
20-
| Last Bonding Height | 4 bytes |
21-
| Unbonding Height | 4 bytes |
22-
| Last Joined Height | 4 bytes |
15+
| Field | Size |
16+
| -------------------- | -------- |
17+
| Public Key | 96 bytes |
18+
| Number | 4 bytes |
19+
| Stake | 8 bytes |
20+
| Last Bonding Height | 4 bytes |
21+
| Unbonding Height | 4 bytes |
22+
| Last Sortition Height| 4 bytes |
2323

2424
- **Public Key** is the Validator's public key.
2525
- **Number** is a sequential and unique number assigned to each validator when it is created for the first time.
2626
The validator number is used to calculate the [state hash](/protocol/blockchain/state-hash) of the blockchain.
2727
- **Stake** holds the Validator's stake or the amount of Pactus coins locked or "staked" by the Validator.
28-
- **Bonding Height** is the last block height that the validator has bonded their stake.
29-
- **Unbonding Height** is the block height that the validator's stake is unbonded.
30-
- **Last Joined Height** is the block height that the validator joined the committee.
28+
- **Last Bonding Height** is the last block height at which the validator bonded stake.
29+
- **Unbonding Height** is the block height at which the validator's stake is unbonded.
30+
If greater than zero, the validator is considered unbonded.
31+
- **Last Sortition Height** is the last block height at which the validator evaluated sortition.
32+
33+
## Delegation (PIP-49)
34+
35+
[PIP-49](https://pips.pactus.org/PIPs/pip-49) introduces an optional delegation section that adds 33 bytes to the structure:
36+
37+
| Field | Size |
38+
| --------------- | -------- |
39+
| Delegate Owner | 21 bytes |
40+
| Delegate Share | 8 bytes |
41+
| Delegate Expiry | 4 bytes |
42+
43+
When the delegation fields are present, the total structure size is 153 bytes. If the delegation section is absent, the validator is not delegated.
44+
45+
- **Delegate Owner** is the address of the stake owner account.
46+
- **Delegate Share** is the stake owner's reward share in nano PAC (within `[0, 0.7 PAC]`).
47+
- **Delegate Expiry** is the block height at which the delegation expires (zero means no expiry).

0 commit comments

Comments
 (0)