Skip to content

Commit d41b150

Browse files
eshabenCopilot
andauthored
update formatting for the protocol section (#806)
* update formatting for the protocol section * update formatting * Update polkadot-protocol/parachain-basics/data-encoding.md Co-authored-by: Copilot <[email protected]> * Update polkadot-protocol/parachain-basics/accounts.md Co-authored-by: Copilot <[email protected]> * formatting fix --------- Co-authored-by: Copilot <[email protected]>
1 parent b4ae44c commit d41b150

34 files changed

+1340
-1302
lines changed

llms.txt

Lines changed: 668 additions & 649 deletions
Large diffs are not rendered by default.

polkadot-protocol/architecture/index.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -12,11 +12,11 @@ Explore Polkadot's architecture, including the relay chain, parachains, and syst
1212

1313
The following provides a brief overview of the role of each chain:
1414

15-
- [**Polkadot relay chain**](/polkadot-protocol/architecture/polkadot-chain/) - the central hub and main chain responsible for the overall security, consensus, and interoperability between all connected chains
15+
- **[Polkadot relay chain](/polkadot-protocol/architecture/polkadot-chain/)**: The central hub and main chain responsible for the overall security, consensus, and interoperability between all connected chains.
1616

17-
- [**System chains**](/polkadot-protocol/architecture/system-chains/) - specialized chains that provide essential services to the ecosystem, like the Asset Hub, Bridge Hub, and Coretime chain
17+
- **[System chains](/polkadot-protocol/architecture/system-chains/)**: Specialized chains that provide essential services to the ecosystem, like the Asset Hub, Bridge Hub, and Coretime chain.
1818

19-
- [**Parachains**](/polkadot-protocol/architecture/parachains/) - individual, specialized blockchains that run parallel to the relay chain and are connected to it
19+
- **[Parachains](/polkadot-protocol/architecture/parachains/)**: Individual, specialized blockchains that run parallel to the relay chain and are connected to it.
2020

2121
Learn more about these components by checking out the articles in this section.
2222

polkadot-protocol/architecture/parachains/consensus.md

Lines changed: 20 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -19,18 +19,18 @@ Collators are responsible for sequencing end-user transactions into blocks and m
1919

2020
Key responsibilities include:
2121

22-
- **Transaction sequencing** - organizing transactions into [Proof of Validity (PoV)](https://wiki.polkadot.network/general/glossary/){target=\_blank} blocks
23-
- **State management** - maintaining parachain states without burdening the relay chain validators
24-
- **Consensus participation** - sending PoV blocks to relay chain validators for approval
22+
- **Transaction sequencing**: Organizing transactions into [Proof of Validity (PoV)](https://wiki.polkadot.network/general/glossary/){target=\_blank} blocks.
23+
- **State management**: Maintaining parachain states without burdening the relay chain validators.
24+
- **Consensus participation**: Sending PoV blocks to relay chain validators for approval.
2525

2626
## Consensus and Validation
2727

2828
Parachain consensus operates in tandem with the relay chain, leveraging Nominated Proof of Stake (NPoS) for shared security. The process ensures parachain transactions achieve finality through the following steps:
2929

30-
1. **Packaging transactions** - collators bundle transactions into PoV blocks (parablocks)
31-
2. **Submission to validator** - parablocks are submitted to a randomly selected subset of relay chain validators, known as paravalidators
32-
3. **Validation of PoV Blocks** - paravalidators use the parachain’s state transition function (already available on the relay chain) to verify transaction validity
33-
4. **Backing and inclusion** - if a sufficient number of positive validations are received, the parablock is backed and included via a para-header on the relay chain
30+
1. **Packaging transactions**: Collators bundle transactions into PoV blocks (parablocks).
31+
2. **Submission to validator**: Parablocks are submitted to a randomly selected subset of relay chain validators, known as paravalidators.
32+
3. **Validation of PoV Blocks**: Paravalidators use the parachain’s state transition function (already available on the relay chain) to verify transaction validity.
33+
4. **Backing and inclusion**: If a sufficient number of positive validations are received, the parablock is backed and included via a para-header on the relay chain.
3434

3535
The following sections describe the actions taking place during each stage of the process.
3636

@@ -40,11 +40,11 @@ Polkadot achieves scalability through execution sharding, where each parachain o
4040

4141
The journey parachain transactions follow to reach consensus and finality can be described as follows:
4242

43-
- **Collators and parablocks:**
43+
- Collators and parablocks:
4444

45-
- Collators, specialized nodes on parachains, package network transactions into Proof of Validity (PoV) blocks, also called parablocks
46-
- These parablocks are sent to a subset of relay chain validators, known as paravalidators, for validation
47-
- The parachain's state transition function (Wasm blob) is not re-sent, as it is already stored on the relay chain
45+
- Collators, specialized nodes on parachains, package network transactions into Proof of Validity (PoV) blocks, also called parablocks.
46+
- These parablocks are sent to a subset of relay chain validators, known as paravalidators, for validation.
47+
- The parachain's state transition function (Wasm blob) is not re-sent, as it is already stored on the relay chain.
4848

4949
```mermaid
5050
flowchart TB
@@ -66,17 +66,17 @@ flowchart TB
6666
Parachain -->|Submit To| Relay
6767
```
6868

69-
- **Validation by paravalidators:**
69+
- Validation by paravalidators:
7070

71-
- Paravalidators are groups of approximately five relay chain validators, randomly assigned to parachains and shuffled every minute
72-
- Each paravalidator downloads the parachain's Wasm blob and validates the parablock by ensuring all transactions comply with the parachain’s state transition rules
73-
- Paravalidators sign positive or negative validation statements based on the block’s validity
71+
- Paravalidators are groups of approximately five relay chain validators, randomly assigned to parachains and shuffled every minute.
72+
- Each paravalidator downloads the parachain's Wasm blob and validates the parablock by ensuring all transactions comply with the parachain’s state transition rules.
73+
- Paravalidators sign positive or negative validation statements based on the block’s validity.
7474

75-
- **Backing and approval:**
75+
- Backing and approval:
7676

77-
- If a parablock receives sufficient positive validation statements, it is backed and included on the relay chain as a para-header
78-
- An additional approval process resolves disputes. If a parablock contains invalid transactions, additional validators are tasked with verification
79-
- Validators who back invalid parablocks are penalized through slashing, creating strong incentives for honest behavior
77+
- If a parablock receives sufficient positive validation statements, it is backed and included on the relay chain as a para-header.
78+
- An additional approval process resolves disputes. If a parablock contains invalid transactions, additional validators are tasked with verification.
79+
- Validators who back invalid parablocks are penalized through slashing, creating strong incentives for honest behavior.
8080

8181
```mermaid
8282
flowchart
@@ -113,4 +113,4 @@ It is important to understand that relay chain blocks do not store full parachai
113113

114114
For more technical details, refer to the:
115115

116-
- [Parachain Wiki](https://wiki.polkadot.network/learn/learn-parachains/){target=\_blank} page
116+
- [Parachain Wiki](https://wiki.polkadot.network/learn/learn-parachains/){target=\_blank} page

polkadot-protocol/architecture/polkadot-chain/elastic-scaling.md

Lines changed: 19 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -19,14 +19,14 @@ Elastic scaling enables parachains to process multiple blocks in parallel by uti
1919

2020
Consider a parachain that needs to process four consecutive parablocks. With traditional single-core allocation, the validation process follows a strictly sequential pattern. Each parablock undergoes a two-phase process on the relay chain:
2121

22-
1. **Backing phase** - validators create and distribute validity statements
23-
2. **Inclusion phase** - the parablock is included in the relay chain after availability verification
22+
1. **Backing phase**: Validators create and distribute validity statements.
23+
2. **Inclusion phase**: The parablock is included in the relay chain after availability verification.
2424

2525
Throughout the following diagrams, specific notation is used to represent different components of the system:
2626

27-
- R1, R2, ... - relay chain blocks (produced at ~6-second intervals)
28-
- P1, P2, ... - parachain blocks that need validation and inclusion
29-
- C1, C2, ... - cores on the relay chain
27+
- **R1, R2, ...**: Relay chain blocks (produced at ~6-second intervals).
28+
- **P1, P2, ...**: Parachain blocks that need validation and inclusion.
29+
- **C1, C2, ...**: Cores on the relay chain.
3030

3131
In the single-core scenario (assuming a 6-second relay chain block time), processing four parablocks requires approximately 30 seconds:
3232

@@ -84,33 +84,33 @@ sequenceDiagram
8484

8585
To help interpret the sequence diagrams above, note the following key elements:
8686

87-
- The horizontal axis represents time progression through relay chain blocks (R1-R5)
88-
- Each colored rectangle shows processing on a specific core (C1 or C2)
89-
- In the single-core scenario, all blocks must be processed sequentially on one core
90-
- In the multi-core scenario, blocks are processed in parallel across multiple cores, reducing total time
87+
- The horizontal axis represents time progression through relay chain blocks (R1-R5).
88+
- Each colored rectangle shows processing on a specific core (C1 or C2).
89+
- In the single-core scenario, all blocks must be processed sequentially on one core.
90+
- In the multi-core scenario, blocks are processed in parallel across multiple cores, reducing total time.
9191

9292
The relay chain processes these multiple parablocks as independent validation units during the backing, availability, and approval phases. However, during inclusion, it verifies that their state roots align properly to maintain chain consistency.
9393

9494
From an implementation perspective:
9595

96-
- **Parachain side** - collators must increase their block production rate to utilize multiple cores fully
97-
- **Validation process** - each core operates independently, but with coordinated state verification
98-
- **Resource management** - cores are dynamically allocated based on parachain requirements
99-
- **State consistency** - while backed and processed in parallel, the parablocks maintain sequential state transitions
96+
- **Parachain side**: Collators must increase their block production rate to utilize multiple cores fully.
97+
- **Validation process**: Each core operates independently, but with coordinated state verification.
98+
- **Resource management**: Cores are dynamically allocated based on parachain requirements.
99+
- **State consistency**: While backed and processed in parallel, the parablocks maintain sequential state transitions.
100100

101101
## Benefits of Elastic Scaling
102102

103-
- **Increased throughput** - multiple concurrent cores enable parachains to process transactions at multiples of their previous capacity. By allowing multiple parachain blocks to be validated within each relay chain block cycle, applications can achieve significantly higher transaction volumes
103+
- **Increased throughput**: Multiple concurrent cores enable parachains to process transactions at multiples of their previous capacity. By allowing multiple parachain blocks to be validated within each relay chain block cycle, applications can achieve significantly higher transaction volumes.
104104

105-
- **Lower latency** - transaction finality improves substantially with multi-core processing. Parachains currently achieve 2-second latency with three cores, with projected improvements to 500ms using 12 cores, enabling near-real-time application responsiveness
105+
- **Lower latency**: Transaction finality improves substantially with multi-core processing. Parachains currently achieve 2-second latency with three cores, with projected improvements to 500ms using 12 cores, enabling near-real-time application responsiveness.
106106

107-
- **Resource efficiency** - applications acquire computational resources precisely matched to their needs, eliminating wasteful over-provisioning. Coretime can be purchased at granular intervals (blocks, hours, days), creating cost-effective operations, particularly for applications with variable transaction patterns
107+
- **Resource efficiency**: Applications acquire computational resources precisely matched to their needs, eliminating wasteful over-provisioning. Coretime can be purchased at granular intervals (blocks, hours, days), creating cost-effective operations, particularly for applications with variable transaction patterns.
108108

109-
- **Scalable growth** - new applications can launch with minimal initial resource commitment and scale dynamically as adoption increases. This eliminates the traditional paradox of either over-allocating resources (increasing costs) or under-allocating (degrading performance) during growth phases
109+
- **Scalable growth**: New applications can launch with minimal initial resource commitment and scale dynamically as adoption increases. This eliminates the traditional paradox of either over-allocating resources (increasing costs) or under-allocating (degrading performance) during growth phases.
110110

111-
- **Workload distribution** - parachains intelligently distribute workloads across cores during peak demand periods and release resources when traffic subsides. Paired with secondary coretime markets, this ensures maximum resource utilization across the entire network ecosystem
111+
- **Workload distribution**: Parachains intelligently distribute workloads across cores during peak demand periods and release resources when traffic subsides. Paired with secondary coretime markets, this ensures maximum resource utilization across the entire network ecosystem.
112112

113-
- **Reliable performance** - end-users experience reliable application performance regardless of network congestion levels. Applications maintain responsiveness even during traffic spikes, eliminating performance degradation that commonly impacts blockchain applications during high-demand periods
113+
- **Reliable performance**: End-users experience reliable application performance regardless of network congestion levels. Applications maintain responsiveness even during traffic spikes, eliminating performance degradation that commonly impacts blockchain applications during high-demand periods.
114114

115115
## Use Cases
116116

0 commit comments

Comments
 (0)