Skip to content

Commit

Permalink
Polkadot Protocol > Architecture > Parachains > Consensus (#184)
Browse files Browse the repository at this point in the history
* Parachain Consensus

* fix: making consensus page visible

* Fix text formatting

* Update polkadot-protocol/architecture/parachains/consensus.md

Co-authored-by: Nicolás Hussein <[email protected]>

* Update consensus.md

* Polkadot Protocol > On-Chain Governance > Origins & Tracks (#178)

* create initial origins & tracks page

* add tracks subsection

* quick clean up

* fix: adding desc

* fix: paraphrasing intro a bit to improve the storytelling

* fix: wording and adding reference to ##Track Parameters section

* fix: formatting on the ##Origins section

* fix: formatting and wording on the ###How Origin Works section

* fix: formatting last sections

* removed origin examples

* remove comments from sections

* enable commented on-chain governance section

* fish gutted

* Apply suggestions from code review

Co-authored-by: Erin Shaben <[email protected]>

---------

Co-authored-by: Erin Shaben <[email protected]>
Co-authored-by: nhussein11 <[email protected]>
Co-authored-by: DAWN KELLY <[email protected]>
Co-authored-by: Nicolás Hussein <[email protected]>

* Develop > Smart Contracts > Native EVM contracts (#173)

* fix: wip

* fix: adding wip

* fix: adding todos for future reference

* fix: cleaning up

* fix: adding  components diagram

* fix: adding the rest of native evm contracts page

* fix: wording

* move page and apply formatting updates

* feedback from review applied, grammar and formatting pass, some polishing

* Update develop/smart-contracts/evm/native-evm-contracts.md

Co-authored-by: Erin Shaben <[email protected]>

* two tiny formatting changes

---------

Co-authored-by: Erin Shaben <[email protected]>
Co-authored-by: DAWN KELLY <[email protected]>

* fix: adding h1 to the page (#181)

* Develop > Smart Contracts > Wasm (ink!) (#170)

* wip: Add ink! page

* wip: contract structure

* Add storage section

* Add constructors

* Add remaining sections

* Improve grammar

* Add description

* Extract to snippets

* Apply suggestions from code review

Co-authored-by: Nicolás Hussein <[email protected]>

* update to file

* formatting updates

* Add pallet contracts explanation

---------

Co-authored-by: Erin Shaben <[email protected]>
Co-authored-by: Nicolás Hussein <[email protected]>

* fix: pallet testing wording (#190)

* Structural changes to root level pages (#183)

* make structural changes

* add script to add a class to root-level index pages

* add templates

* remove icons (#179)

* Add XCM Channels (#188)

* Add xcm channels

* Fix things

* More fixes

* Add where to go next

* Apply suggestions from code review

Co-authored-by: Erin Shaben <[email protected]>
Co-authored-by: Nicolás Hussein <[email protected]>

* Add description

* Update description

---------

Co-authored-by: Erin Shaben <[email protected]>
Co-authored-by: Nicolás Hussein <[email protected]>

* Develop > Toolkit > Interoperability > Asset Transfer API (#186)

* Add asset-transfer-api

* Apply suggestions from code review

Co-authored-by: Nicolás Hussein <[email protected]>

* a few updates, adds links

* Apply suggestions from code review

Co-authored-by: Erin Shaben <[email protected]>

---------

Co-authored-by: Dawn Kelly <[email protected]>
Co-authored-by: Nicolás Hussein <[email protected]>
Co-authored-by: DAWN KELLY <[email protected]>
Co-authored-by: Erin Shaben <[email protected]>

* Tutorials > Blockchains > Custom Blockchains (#185)

* Add build-a-blockchain

* Add build-a-parachain

* updates missing links, etc for Asset Hub pages

* updates links plus formatting nits for pages in custom blockchains > build a blockchain section

* fixes links and terminal elements for Build a Parachain section pages

* Apply suggestions from code review

Co-authored-by: Nicolás Hussein <[email protected]>

---------

Co-authored-by: DAWN KELLY <[email protected]>
Co-authored-by: Erin Shaben <[email protected]>
Co-authored-by: Nicolás Hussein <[email protected]>

* infrastructure and protocol index page meta descriptions (#191)

* Develop > Interoperability > Introduction to XCM (#147)

* Added 'introduction-to-xcm' page, including 4 .rs code snippets and an imagage describing the XCM Tech stack

* Changed 'usecases' to 'use cases'

Co-authored-by: Nicolás Hussein <[email protected]>

* Added GH link to xcm-format

Co-authored-by: Nicolás Hussein <[email protected]>

* Layout update / styling

Co-authored-by: Nicolás Hussein <[email protected]>

* Layout updates / styling

Co-authored-by: Nicolás Hussein <[email protected]>

* Update develop/interoperability/intro-to-xcm.md

Co-authored-by: Nicolás Hussein <[email protected]>

* Update develop/interoperability/intro-to-xcm.md

Co-authored-by: Nicolás Hussein <[email protected]>

* Update develop/interoperability/intro-to-xcm.md

Co-authored-by: Nicolás Hussein <[email protected]>

* formatting & grammar pass

* moved code snippet to new IA location, updated to use lines from single snippet

* Update develop/interoperability/intro-to-xcm.md

Co-authored-by: Francisco Aguirre <[email protected]>

* Update develop/interoperability/intro-to-xcm.md

Co-authored-by: Francisco Aguirre <[email protected]>

* Update develop/interoperability/intro-to-xcm.md

Co-authored-by: Francisco Aguirre <[email protected]>

* Introduction to XCM suggested edits

* fix: paraphrasing

* updates to show nav, formatting nits

---------

Co-authored-by: Nicolás Hussein <[email protected]>
Co-authored-by: DAWN KELLY <[email protected]>
Co-authored-by: Erin Shaben <[email protected]>
Co-authored-by: Francisco Aguirre <[email protected]>
Co-authored-by: nhussein11 <[email protected]>

* [Polkadot Wiki Migration] Agile Coretime (#172)

* [Polkadot Wiki Migration] Agile Coretime

This page provides an overview of Agile Coretime on Polkadot

* run grammarly and update flow

* update .pages

* add Wiki link

---------

Co-authored-by: Erin Shaben <[email protected]>

* relativeLinks fix (#197)

* Set up the bare minimum index pages (#200)

* make structural changes

* add script to add a class to root-level index pages

* add templates

* add metatags

* Update develop/index.md

* Update develop/toolkit/blockchain/index.md

* add base level index pages

* update template name

---------

Co-authored-by: Kevin Neilson <[email protected]>

* Develop > Smart Contracts > Overview (#174)

* introduction

* final draft

* Apply suggestions from code review

Co-authored-by: 0xLucca <[email protected]>
Co-authored-by: Nicolás Hussein <[email protected]>

* improve mermaids

* formatting and edits

---------

Co-authored-by: Erin Shaben <[email protected]>
Co-authored-by: 0xLucca <[email protected]>
Co-authored-by: Nicolás Hussein <[email protected]>
Co-authored-by: DAWN KELLY <[email protected]>

* [Polkadot Wiki Migration] How to Validate (Polkadot) (#45)

* add initial content

* Add kusama too cause why not

* remove section

* stuff

* set up validator page and validator requirements page - WIP

* finishes out writing, needs edits and grammarly

* adds TODO with question for tech content team

* updates directories and paths for remaining images

* grammarly pass

* moves optimize config info to General Management

* fix: adding missing images

* Moves install polkadot binaries to requirements, updates code snippet location and path

* updates bonding DOT section

* removes legacy infra/validators folder and contents

* applying review feedback

* Apply suggestions from code review

Co-authored-by: Erin Shaben <[email protected]>

* applying more review feedback

* now with more edits!

* updating image location and paths

* Develop > Testing > Setup (#111)

* fix: wip

* fix: adding title and desc

* fix: adding setup page completed

* fix: adding code snippets

* Apply suggestions from code review

Co-authored-by: bader y <[email protected]>

* fix: removing redundant paragraph

* fix: unused md line

* fix: removing paragraph

* fix: adding reference to the end of the article

* fix: adding custom genesis config

* Apply suggestions from code review

Co-authored-by: bader y <[email protected]>

* formatting pass, grammarly

* Apply suggestions from code review

Co-authored-by: Erin Shaben <[email protected]>

---------

Co-authored-by: bader y <[email protected]>
Co-authored-by: DAWN KELLY <[email protected]>
Co-authored-by: Erin Shaben <[email protected]>

* [Substrate.io] Deterministic Runtime (#26)

* Add initial page

* rewrite most things

* remove section

* apply suggestions and formatting and grammar changes

* Apply suggestions from code review

Co-authored-by: 0xLucca <[email protected]>

* add to variables.yml

* fix: adding wip

* fix: updating wording

* Apply suggestions from code review

Co-authored-by: Erin Shaben <[email protected]>

---------

Co-authored-by: Erin Shaben <[email protected]>
Co-authored-by: 0xLucca <[email protected]>
Co-authored-by: nhussein11 <[email protected]>
Co-authored-by: Nicolás Hussein <[email protected]>

* Add Develop->Integrations section (#133)

* Add wallets and indexers

* Add oracles

* Add description

* Remove others page

* Apply grammarly

* Apply feedback

* Apply suggestions from code review

Co-authored-by: Nicolás Hussein <[email protected]>

* Fix descriptions

* Apply suggestions from code review

Co-authored-by: Erin Shaben <[email protected]>

---------

Co-authored-by: Nicolás Hussein <[email protected]>
Co-authored-by: Erin Shaben <[email protected]>

* Add description to README.md (#126)

* add readme file

* adds link per review feedback

---------

Co-authored-by: DAWN KELLY <[email protected]>

* Move install-deps to get-started section (#148)

* Polkadot Protocol > Basics > Data Encoding (#114)

* create data-encoding page

* add description

* Apply suggestions from code review

Co-authored-by: Nicolás Hussein <[email protected]>
Co-authored-by: 0xLucca <[email protected]>

* amend comments

* format text

Co-authored-by: 0xLucca <[email protected]>

* Apply suggestions from code review

Co-authored-by: Erin Shaben <[email protected]>

* applies review feedback

* Update polkadot-protocol/basics/data-encoding.md

Co-authored-by: Kevin Neilson <[email protected]>

* Update polkadot-protocol/basics/data-encoding.md

Co-authored-by: Kevin Neilson <[email protected]>

---------

Co-authored-by: Nicolás Hussein <[email protected]>
Co-authored-by: 0xLucca <[email protected]>
Co-authored-by: Dawn Kelly <[email protected]>
Co-authored-by: Erin Shaben <[email protected]>
Co-authored-by: DAWN KELLY <[email protected]>
Co-authored-by: Kevin Neilson <[email protected]>

* Develop > Testing > Runtime (#116)

* fix: wip

* fix: adding runtime testing page and code snippets

* fix: adding reference to pallet testing page

* fix: updating reference route

* grammarly, formatting pass edits

* Apply suggestions from code review

Co-authored-by: Erin Shaben <[email protected]>

* fix: removing conclusion header

---------

Co-authored-by: DAWN KELLY <[email protected]>
Co-authored-by: Erin Shaben <[email protected]>

* IA Update - polkadot-protocol > Basics >Accounts  (#108)

* updates accounts for new IA

* updates for new IA for Accounts (combines 3 pages)

* deletes unneeded empty folders

* updates substrate reference to pdot sdk

* Apply suggestions from code review

Co-authored-by: Erin Shaben <[email protected]>

* updates per review feedback

* Apply suggestions from code review

Co-authored-by: Erin Shaben <[email protected]>

* deletes unused image

---------

Co-authored-by: Erin Shaben <[email protected]>

* Maintenance -> Storage Migrations (#118)

* wip: storage migration

* Information ready

* Improve

* Add description

* Extract code to snippets

* Improvements

* Update develop/blockchains/maintenance/storage-migrations.md

Co-authored-by: Nicolás Hussein <[email protected]>

* Started edits, WIP

* grammarly, formatting updates

* adds link for Rust panic info

* Apply suggestions

* Apply suggestions from code review

Co-authored-by: Erin Shaben <[email protected]>

* Apply suggestions from code review

Co-authored-by: Erin Shaben <[email protected]>

---------

Co-authored-by: Nicolás Hussein <[email protected]>
Co-authored-by: DAWN KELLY <[email protected]>
Co-authored-by: Erin Shaben <[email protected]>

* IA update - creates Asset Hub page for Protocol section (#112)

* creates Asset Hub page for Protocol section

* review feedback

* feedback applied

* Apply suggestions from code review

Co-authored-by: Erin Shaben <[email protected]>

* review feedback

---------

Co-authored-by: Erin Shaben <[email protected]>

* Polkadot Protocol > Basics > Chain Data (#143)

* adds understanding metadata to intro to blockchain dev

* Polkadot Protocol > Basics > Chain Data

* moves code snippets and updates paths in md file

* review feedback applied

* Apply suggestions from code review

Co-authored-by: Kevin Neilson <[email protected]>

* Apply suggestions from code review

Co-authored-by: Erin Shaben <[email protected]>

---------

Co-authored-by: Kevin Neilson <[email protected]>
Co-authored-by: Erin Shaben <[email protected]>

* Polkadot Protocol > Basics > Randomness (#113)

* create randomness page

* Update polkadot-protocol/basics/randomness.md

Co-authored-by: Nicolás Hussein <[email protected]>

* Update polkadot-protocol/basics/randomness.md

Co-authored-by: Nicolás Hussein <[email protected]>

* Update polkadot-protocol/basics/randomness.md

Co-authored-by: Nicolás Hussein <[email protected]>

* Update polkadot-protocol/basics/randomness.md

Co-authored-by: Nicolás Hussein <[email protected]>

* Update polkadot-protocol/basics/randomness.md

Co-authored-by: Nicolás Hussein <[email protected]>

* Update polkadot-protocol/basics/randomness.md

Co-authored-by: Nicolás Hussein <[email protected]>

* Update polkadot-protocol/basics/randomness.md

Co-authored-by: Erin Shaben <[email protected]>

* Update polkadot-protocol/basics/randomness.md

Co-authored-by: Erin Shaben <[email protected]>

* Update polkadot-protocol/basics/randomness.md

Co-authored-by: Erin Shaben <[email protected]>

* Update polkadot-protocol/basics/randomness.md

Co-authored-by: Erin Shaben <[email protected]>

* Update polkadot-protocol/basics/randomness.md

Co-authored-by: Erin Shaben <[email protected]>

* Update polkadot-protocol/basics/randomness.md

Co-authored-by: Erin Shaben <[email protected]>

* Update polkadot-protocol/basics/randomness.md

Co-authored-by: Erin Shaben <[email protected]>

* Update polkadot-protocol/basics/randomness.md

Co-authored-by: Erin Shaben <[email protected]>

* Update polkadot-protocol/basics/randomness.md

Co-authored-by: Erin Shaben <[email protected]>

* Update polkadot-protocol/basics/randomness.md

Co-authored-by: Erin Shaben <[email protected]>

* Update polkadot-protocol/basics/randomness.md

Co-authored-by: Erin Shaben <[email protected]>

* Update polkadot-protocol/basics/randomness.md

Co-authored-by: Erin Shaben <[email protected]>

* Update polkadot-protocol/basics/randomness.md

Co-authored-by: Erin Shaben <[email protected]>

* Link RANDAO and VRF to the sections below

* Apply suggestions from code review

Co-authored-by: Erin Shaben <[email protected]>
Co-authored-by: Nicolás Hussein <[email protected]>

* applies feedback from review

* review feedback applied

* Apply suggestions from code review

Co-authored-by: Erin Shaben <[email protected]>

---------

Co-authored-by: Nicolás Hussein <[email protected]>
Co-authored-by: Erin Shaben <[email protected]>
Co-authored-by: Dawn Kelly <[email protected]>
Co-authored-by: DAWN KELLY <[email protected]>

* Build > Blockchains > Get Started > Deploy a Blockchain to Polkadot (#129)

* add: wip

* fix: adding overview page for deployment section

* add: overview page

* fix: wording

* Apply suggestions from code review

Co-authored-by: bader y <[email protected]>

* fix: wording

* Update develop/blockchains/deployment/overview.md

Co-authored-by: 0xLucca <[email protected]>

* fix: review comments applied

* Apply suggestions from code review

Co-authored-by: bader y <[email protected]>

* Apply suggestions from code review

Co-authored-by: Erin Shaben <[email protected]>

* fix: re-mapping page

* Revert "fix: re-mapping page"

This reverts commit 4e6ab1d.

* fix: populating `deploy-blockchain-to-polkadot`

* fix: removing overview page from deployment section

* fix: removing empty line

---------

Co-authored-by: bader y <[email protected]>
Co-authored-by: 0xLucca <[email protected]>
Co-authored-by: Erin Shaben <[email protected]>

* API Libraries > Polkadot API (PAPI) (#138)

* add: papi wip

* fix: adding api instantiation section

* fix: final content of papi

* fix: apply grammarly

* fix: adding code snippets

* Apply suggestions from code review

Co-authored-by: 0xLucca <[email protected]>

* fix: typo

* fix: link to gh repo of papi

* Apply suggestions from code review

Co-authored-by: Erin Shaben <[email protected]>

* fix: paraphrasing

* fix: updating wording

* Apply suggestions from code review

Co-authored-by: Erin Shaben <[email protected]>

* fix: improvements

---------

Co-authored-by: 0xLucca <[email protected]>
Co-authored-by: Erin Shaben <[email protected]>

* updates for new IA

* Apply suggestions from code review

Co-authored-by: Nicolás Hussein <[email protected]>

* adds description and intro to General Management

* combines the two General Management pages into a single one here

* merges the content from the two versions of this page, new intro and moved all the needed snippets

* adds reference for current minimum bond

* applying feedback

* link updates, fixes

* edit

* edits

* progress

* edit

* full node

* setup full node page

* update set up val page

* updates

* updates

* sort out randomness page

* revise monitoring

* add sudo where needed

* stop validating

* Apply suggestions from code review

Co-authored-by: Nicolás Hussein <[email protected]>

* adds back set-up-validator page

* updates .pages to display nav

* clean up set up full node

---------

Co-authored-by: DAWN KELLY <[email protected]>
Co-authored-by: nhussein11 <[email protected]>
Co-authored-by: Dawn Kelly <[email protected]>
Co-authored-by: Erin Shaben <[email protected]>
Co-authored-by: Nicolás Hussein <[email protected]>
Co-authored-by: 0xLucca <[email protected]>
Co-authored-by: Andreja Markovic <[email protected]>
Co-authored-by: Kevin Neilson <[email protected]>

* Develop > Interoperability > XCM Config  (#177)

* fix: adding wip

* fix: add wip

* fix: wrapping up config items

* fix: add wip

* fix: adding code snippets

* fix: wording

* minor formatting updates

* fix: xcm-executor link

* fix: xcm-builder link

* fix: adding XCMs

* fix: replacing messages by XCMs

* fix: clarifying traits

* fix: adding clarification for fungibleadapter

* fix: hrmp added

---------

Co-authored-by: Erin Shaben <[email protected]>

* remove leftover snippets and pages (#199)

* remove leftover snippets and pages

* remove others.md

* Add Metatags for Develop and tutorial sections (#196)

* add metatags

* Update develop/index.md

* Update develop/toolkit/blockchain/index.md

* Update develop/toolkit/api-libraries/index.md

Co-authored-by: Nicolás Hussein <[email protected]>

---------

Co-authored-by: Erin Shaben <[email protected]>
Co-authored-by: Nicolás Hussein <[email protected]>

* Polkadot Protocol > Architecture > Parachains > Overview (#157)

* draft so far

* fix: add mermaid diagram

* fix: adding more mermaid diagrams

* fix: adding pending sections

* fix: grammarly pass

* fix: wording

* fix: removing empty lines

* Apply suggestions from code review

Co-authored-by: 0xLucca <[email protected]>

* add base index page

* Apply suggestions from code review

---------

Co-authored-by: Erin Shaben <[email protected]>
Co-authored-by: nhussein11 <[email protected]>
Co-authored-by: Nicolás Hussein <[email protected]>
Co-authored-by: 0xLucca <[email protected]>

* Develop > Networks (#193)

* wip: networks

* Add networks page

* Apply suggestions

* Apply suggestions from code review

Co-authored-by: Erin Shaben <[email protected]>

* reformats, adds RPC endpoints

* adds reference for runtimes

* remove characteristics

---------

Co-authored-by: Erin Shaben <[email protected]>
Co-authored-by: DAWN KELLY <[email protected]>

* Develop > Toolkit > Blockchain > Spawn Testing Chain (#154)

* updates zombienet for new IA

* apply review feedback

* applying review feedback - WIP

* Updating Installation page for zombienet

* edits pass

* updating snippet & image locations and paths

* Splitting pages and moving things - still WIP

* moves code snippets & images, updates paths, all links tested

* applied review feedback

* rev

* fix terminal

* add base index pages and clean up toml files

* minor changes

---------

Co-authored-by: Kevin Neilson <[email protected]>
Co-authored-by: Erin Shaben <[email protected]>

* Interoperability > Testing and Debugging  (#182)

* fix: adding wip

* fix: adding xcm simulator

* fix: wip emulator

* fix: wip

* fix: wip emulator

* fix: adding desc

* Update develop/interoperability/test-and-debug.md

Co-authored-by: 0xLucca <[email protected]>

* Apply suggestions from code review

---------

Co-authored-by: 0xLucca <[email protected]>
Co-authored-by: Erin Shaben <[email protected]>

* [FIX] - Empty links "Polkadot Protocol" section (#195)

* fix: updating links polkadot-protocol/architecture/polkadot-chain/overview.md

* fix: updating links polkadot-protocol/architecture/system-chains/coretime.md

* fix: updating links polkadot-protocol/architecture/system-chains/overview.md

* fix: updating links polkadot-protocol/basics/block-transactions-fees/blocks.md

* fix: updating links polkadot-protocol/basics/blocks-transactions-fees/fees.md

* fix: updating links polkadot-protocol/basics/accounts.md

* fix: updating links polkadot-protocol/basics/chain-data.md

* fix: updating links polkadot-protocol/basics/data-encoding.md

* fix: updating links polkadot-protocol/basics/randomness.md

* fix: updating links polkadot-protocol/basics/randomness.md (2)

* update terminal elements

* Update polkadot-protocol/basics/blocks-transactions-fees/fees.md

---------

Co-authored-by: Erin Shaben <[email protected]>

* Customize protocol index pages (#201)

* make structural changes

* add script to add a class to root-level index pages

* add templates

* add metatags

* Update develop/index.md

* Update develop/toolkit/blockchain/index.md

* add base level index pages

* update template name

* add more to the polkadot protocol index pages

* fix a few links

* rev

---------

Co-authored-by: Kevin Neilson <[email protected]>

* [FIX] - Empty links "Develop" section (#202)

* fix: updating links develop/blockchains/custom-blockchains/add-existing-pallets.md

* fix: updating links develop/blockchains/custom-blockchains/make-custom-pallets.md

* fix: updating links develop/blockchains/custom-blockchains/pallet-testing.md

* fix: updating links develop/blockchains/deployment/generate-chain-specs.md

* fix: updating links develop/blockchains/get-started/build-custom-blockchains.md

* fix: updating links develop/blockchains/get-started/deploy-blockchain-to-polkadot.md

* fix: updating links develop/parachain-devs/system-parachains/register-a-local-asset.md

* fix: updating links develop/parachain-devs/system-parachains/register-a-foreign-asset.md

* link

* rev

* link fixes

* update terminal elements

* add todo

---------

Co-authored-by: Kevin Neilson <[email protected]>
Co-authored-by: Erin Shaben <[email protected]>

* [FIX] - Empty links "Infrastructure" section (#198)

* fix: updating links infra section

* update terminal elements

* rev

---------

Co-authored-by: Erin Shaben <[email protected]>
Co-authored-by: Kevin Neilson <[email protected]>

* update disclaimer (#204)

* fix: updating page

* formatting review

* Update polkadot-protocol/architecture/parachains/consensus.md

Co-authored-by: 0xLucca <[email protected]>

* fix: adding mermaid diagram

---------

Co-authored-by: nhussein11 <[email protected]>
Co-authored-by: 0xLucca <[email protected]>
Co-authored-by: Nicolás Hussein <[email protected]>
Co-authored-by: Andreja Markovic <[email protected]>
Co-authored-by: Erin Shaben <[email protected]>
Co-authored-by: DAWN KELLY <[email protected]>
Co-authored-by: 0xLucca <[email protected]>
Co-authored-by: Dawn Kelly <[email protected]>
Co-authored-by: Remy LeBerre - Parity <[email protected]>
Co-authored-by: Francisco Aguirre <[email protected]>
Co-authored-by: Kevin Neilson <[email protected]>
Co-authored-by: albertov19 <[email protected]>
Co-authored-by: bader y <[email protected]>
  • Loading branch information
14 people authored Nov 24, 2024
1 parent 088915c commit 42f00da
Show file tree
Hide file tree
Showing 3 changed files with 103 additions and 2 deletions.
2 changes: 1 addition & 1 deletion polkadot-protocol/architecture/parachains/.pages
Original file line number Diff line number Diff line change
Expand Up @@ -2,4 +2,4 @@ title: Parachains
nav:
- index.md
- 'Overview': overview.md
# - 'Consensus': consensus.md
- 'Consensus': consensus.md
101 changes: 101 additions & 0 deletions polkadot-protocol/architecture/parachains/consensus.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,101 @@
---
title: Parachain Consensus
description: Understand how the blocks authored by parachain collators are secured by the relay chain validators and how the parachain transactions achieve finality.
---

# Parachain Consensus

## Introduction

Parachains are independent blockchains built with the Polkadot SDK, designed to leverage Polkadot’s relay chain for shared security and transaction finality. These specialized chains operate as part of Polkadot’s execution sharding model, where each parachain manages its own state and transactions while relying on the relay chain for validation and consensus.

At the core of parachain functionality are collators, specialized nodes that sequence transactions into blocks and maintain the parachain’s state. Collators optimize Polkadot’s architecture by offloading state management from the relay chain, allowing relay chain validators to focus solely on validating parachain blocks.

This guide explores how parachain consensus works, including the roles of collators and validators, and the steps involved in securing parachain blocks within Polkadot’s scalable and decentralized framework.

## The Role of Collators

Collators are responsible for sequencing end-user transactions into blocks and maintaining the current state of their respective parachains. Their role is akin to Ethereum’s sequencers but optimized for Polkadot's architecture.

Key responsibilities include:

- **Transaction sequencing** - organizing transactions into [Proof of Validity (PoV)](https://wiki.polkadot.network/docs/glossary#proof-of-validity){target=\_blank} blocks
- **State management** - maintaining parachain states without burdening the relay chain validators
- **Consensus participation** - sending PoV blocks to relay chain validators for approval

## Consensus and Validation

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:

1. **Packaging transactions** - collators bundle transactions into PoV blocks (parablocks)
2. **Submission to validator** - parablocks are submitted to a randomly selected subset of relay chain validators, known as paravalidators
3. **Validation of PoV Blocks** - paravalidators use the parachain’s state transition function (already available on the relay chain) to verify transaction validity
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

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

### Path of a Parachain Block

Polkadot achieves scalability through execution sharding, where each parachain operates as an independent shard with its own blockchain and state. Shared security for all parachains is provided by the relay chain, powered by [Nominated Proof of Staking (NPoS)](/polkadot-protocol/glossary/#nominated-proof-of-stake-npos){target=\_blank}. This framework allows parachains to focus on transaction processing and state management, while the relay chain ensures validation and finality.

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

- **Collators and parablocks:**

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

- **Validation by paravalidators:**

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

- **Backing and approval:**

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

```mermaid
flowchart TB
subgraph Parachain
Txs[Network Transactions]
Collator[Collator Node]
ParaBlock[Parablock + PoV]
end
subgraph RelayChain["Relay Chain"]
direction LR
PValidators[Paravalidators\n~5 validators per parachain]
Backing[Backing Process]
Header[Para-header on Relay Chain]
Approval[Approval Process]
Dispute[Dispute Resolution]
Slashing[Slashing Mechanism]
end
%% Main Flow
Txs -->|Package transactions| Collator
Collator -->|Create| ParaBlock
ParaBlock -->|Submit to| PValidators
%% Validation Process
PValidators -->|Download Wasm\nValidate block| Backing
Backing -->|If valid signatures| Header
Header -->|Additional verification| Approval
%% Dispute Flow
Approval -->|If invalid detected| Dispute
Dispute -->|Penalize dishonest validators| Slashing
```

It is important to understand that relay chain blocks do not store full parachain blocks (parablocks). Instead, they include para-headers, which serve as summaries of the backed parablocks. The complete parablock remains within the parachain network, maintaining its autonomy while relying on the relay chain for validation and finality.

## Where to Go Next

For more technical details, refer to the:

- [Parachain Wiki](https://wiki.polkadot.network/docs/learn-parachains){target=_blank} page
- [Polkadot SDK Implementation Guide](/develop/blockchains/get-started/){target=\_blank} section
2 changes: 1 addition & 1 deletion polkadot-protocol/architecture/parachains/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,4 +12,4 @@ Explore how parachains achieve consensus and leverage shared security through Po

## In This Section

:::INSERT_IN_THIS_SECTION:::
:::INSERT_IN_THIS_SECTION:::

0 comments on commit 42f00da

Please sign in to comment.