From 60542a0dc6b78e37def995c8cce399fb6bcda460 Mon Sep 17 00:00:00 2001
From: todortodorovic <95745674+todortodorovic@users.noreply.github.com>
Date: Sat, 15 Nov 2025 17:19:40 +0100
Subject: [PATCH 1/3] polkadot-hub overview
---
.nav.yml | 1 +
reference/polkadot-hub/index.md | 110 +++++++++++++++++++++++++++++++-
2 files changed, 110 insertions(+), 1 deletion(-)
diff --git a/.nav.yml b/.nav.yml
index 0bb75ad17..b22436b4d 100644
--- a/.nav.yml
+++ b/.nav.yml
@@ -5,3 +5,4 @@ nav:
- 'Chain Interactions': chain-interactions
# 'Get Support': get-support
- 'Nodes and Validators': nodes-and-validators
+ - 'Technical Reference': reference
\ No newline at end of file
diff --git a/reference/polkadot-hub/index.md b/reference/polkadot-hub/index.md
index 30404ce4c..660eba12f 100644
--- a/reference/polkadot-hub/index.md
+++ b/reference/polkadot-hub/index.md
@@ -1 +1,109 @@
-TODO
\ No newline at end of file
+---
+title: Polkadot Hub Overview
+description: Learn how Polkadot Hub serves as the entry point to Polkadot, providing access to smart contracts, staking, governance, identity management, and cross-ecosystem interoperability.
+categories: Basics, Polkadot Protocol, Polkadot Hub
+---
+
+## Introduction
+
+Polkadot Hub is the entry point to Polkadot for all users and application developers. It provides access to essential Web3 services including smart contracts, staking, governance, identity management, and cross-ecosystem interoperability—without requiring you to deploy or manage a parachain.
+
+The Hub encompasses a set of core functionality that enables developers and users to build and interact with applications on Polkadot. Rather than being a single chain, the Hub represents a collection of specialized system parachains and services working together seamlessly to deliver a unified platform experience. This modular approach allows you to interact with different services optimized for specific use cases, all while benefiting from Polkadot's shared security.
+
+## What the Hub Provides
+
+The Polkadot Hub enables a range of essential capabilities:
+
+### Basic User Capabilities
+
+Whether you're just getting started or building complex applications, the Hub supports:
+
+- **Hold, send, and receive DOT** and other assets across the network
+- **Stake DOT** to participate in network security and earn rewards
+- **Vote in governance** referendums and shape Polkadot's future
+- **Create assets** (both fungible tokens and NFTs) for your projects
+- **Pay transaction fees** in any asset, not just DOT
+- **Register as an individual** and establish your on-chain identity
+
+### Advanced Developer Capabilities
+
+For more sophisticated use cases, the Hub enables:
+
+- **Deploy Ethereum-compatible smart contracts** using Solidity or other EVM languages
+- **Build decentralized applications** that leverage Polkadot's security and interoperability
+- **Manage cross-chain interactions** through XCM messaging with other parachains
+- **Set verified identities** and apply for network opportunities like the Ambassador Program
+- **Join collectives** and participate in governance organizations with specialized roles
+- **Access fee-efficient asset operations** for creating and managing tokens at scale
+
+## Core Components
+
+The Polkadot Hub consists of several specialized system parachains and services working together:
+
+### Asset Hub
+
+[Asset Hub](/reference/polkadot-hub/assets-and-smart-contracts/){target=\_blank} provides the foundation for on-chain asset management. Create, manage, and transfer fungible tokens and NFTs across the ecosystem. Asset Hub offers significantly lower transaction fees—approximately one-tenth of relay chain costs—and reduced deposit requirements, making it ideal for projects managing digital assets at scale. It also enables payment of transaction fees in non-native assets, providing flexibility for developers and users.
+
+### People Chain
+
+[People Chain](/reference/polkadot-hub/people-and-identity/){target=\_blank} powers Polkadot's decentralized identity system. Establish verifiable on-chain identities, control disclosure of personal information, and receive verification from trusted registrars. People Chain enables secure identity management with hierarchical sub-account support, forming the foundation for trusted interactions throughout the ecosystem.
+
+### Bridge Hub
+
+[Bridge Hub](/reference/polkadot-hub/bridging/){target=\_blank} facilitates trustless interactions between Polkadot and external blockchains like Ethereum and Kusama. Through implementations like Snowbridge, Bridge Hub enables secure cross-chain communication using on-chain light clients and trustless relayers. This component ensures seamless interoperability beyond the Polkadot ecosystem.
+
+### Consensus & Security
+
+[Consensus and Security](/reference/polkadot-hub/consensus-and-security/){target=\_blank} covers the fundamental mechanisms that protect the network. Learn about validator participation, how the relay chain validates all transactions, and the cryptoeconomic incentives that secure Polkadot. Understanding these mechanisms is essential for validators and anyone building critical infrastructure on the network.
+
+### Collectives & DAOs
+
+[Collectives and DAOs](/reference/polkadot-hub/collectives-and-daos/){target=\_blank} enable specialized governance organizations within Polkadot. Participate in collective membership, manage treasury operations, and engage in coordinated decision-making with groups aligned around specific purposes. This functionality supports the creation of autonomous organizations on Polkadot.
+
+## Where to Go Next
+
+Explore specific Hub functionality through these sections:
+
+
+
+- Learn **Asset Hub**
+
+ ---
+
+ Manage fungible tokens and NFTs with low fees and flexible asset operations.
+
+ [:octicons-arrow-right-24: Reference](/reference/polkadot-hub/assets-and-smart-contracts/)
+
+- Learn **People Chain**
+
+ ---
+
+ Establish and verify decentralized identities for trusted interactions on Polkadot.
+
+ [:octicons-arrow-right-24: Reference](/reference/polkadot-hub/people-and-identity/)
+
+- Learn **Bridge Hub**
+
+ ---
+
+ Facilitate trustless cross-chain interactions with Ethereum and other blockchains.
+
+ [:octicons-arrow-right-24: Reference](/reference/polkadot-hub/bridging/)
+
+- Learn **Consensus & Security**
+
+ ---
+
+ Understand how Polkadot validates transactions and secures the network.
+
+ [:octicons-arrow-right-24: Reference](/reference/polkadot-hub/consensus-and-security/)
+
+- Learn **Collectives & DAOs**
+
+ ---
+
+ Participate in specialized governance organizations with coordinated decision-making.
+
+ [:octicons-arrow-right-24: Reference](/reference/polkadot-hub/collectives-and-daos/)
+
+
From 333223a582d67a80421c37b8967848c20d37c1d3 Mon Sep 17 00:00:00 2001
From: todortodorovic <95745674+todortodorovic@users.noreply.github.com>
Date: Wed, 19 Nov 2025 21:26:50 +0100
Subject: [PATCH 2/3] split assets and smart-contract
---
reference/index.md | 4 ++--
reference/polkadot-hub/index.md | 22 +++++++++++++++++-----
2 files changed, 19 insertions(+), 7 deletions(-)
diff --git a/reference/index.md b/reference/index.md
index 5602d92de..83fd2eea7 100644
--- a/reference/index.md
+++ b/reference/index.md
@@ -14,12 +14,12 @@ This guide organizes technical documentation across five core areas: Polkadot Hu
## Polkadot Hub
-[Polkadot Hub](/reference/polkadot-hub/){target=\_blank} is the entry point to Polkadot for all users and application developers. It provides access to essential Web3 services, including smart contracts, staking, governance, identity management, and cross-ecosystem interoperability—without requiring you to deploy or manage a parachain.
+[Polkadot Hub](/reference/polkadot-hub/){target=\_blank} is the entry point to Polkadot for all users and application developers. It provides access to essential Web3 services including smart contracts, asset management, staking, governance, identity management, and cross-ecosystem interoperability—without requiring you to deploy or manage a parachain.
The Hub encompasses a set of core functionality that enables developers and users to build and interact with applications on Polkadot. Key capabilities include:
- **Smart contracts**: Deploy Ethereum-compatible smart contracts and build decentralized applications.
-- **Assets and tokens**: Create, manage, and transfer fungible tokens and NFTs across the ecosystem.
+- **Asset management**: Create, manage, and transfer fungible tokens and NFTs across the ecosystem.
- **Staking**: Participate in network security and earn rewards by staking DOT.
- **Governance**: Vote on proposals and participate in Polkadot's decentralized decision-making through OpenGov.
- **Identity services**: Register and manage on-chain identities, enabling access to governance roles and network opportunities.
diff --git a/reference/polkadot-hub/index.md b/reference/polkadot-hub/index.md
index 660eba12f..2f09dced5 100644
--- a/reference/polkadot-hub/index.md
+++ b/reference/polkadot-hub/index.md
@@ -31,18 +31,22 @@ For more sophisticated use cases, the Hub enables:
- **Deploy Ethereum-compatible smart contracts** using Solidity or other EVM languages
- **Build decentralized applications** that leverage Polkadot's security and interoperability
+- **Create and manage fungible tokens and NFTs** with low fees and flexible operations
- **Manage cross-chain interactions** through XCM messaging with other parachains
- **Set verified identities** and apply for network opportunities like the Ambassador Program
- **Join collectives** and participate in governance organizations with specialized roles
-- **Access fee-efficient asset operations** for creating and managing tokens at scale
## Core Components
The Polkadot Hub consists of several specialized system parachains and services working together:
-### Asset Hub
+### Smart Contracts
-[Asset Hub](/reference/polkadot-hub/assets-and-smart-contracts/){target=\_blank} provides the foundation for on-chain asset management. Create, manage, and transfer fungible tokens and NFTs across the ecosystem. Asset Hub offers significantly lower transaction fees—approximately one-tenth of relay chain costs—and reduced deposit requirements, making it ideal for projects managing digital assets at scale. It also enables payment of transaction fees in non-native assets, providing flexibility for developers and users.
+[Smart Contracts](/reference/polkadot-hub/smart-contracts/){target=\_blank} on Polkadot Hub enable developers to deploy Ethereum-compatible smart contracts using Solidity and other familiar EVM languages. Build decentralized applications with full access to Polkadot's security, interoperability, and cross-chain capabilities. Smart contracts on the Hub benefit from lower fees and integration with native Polkadot features like identity management and asset operations.
+
+### Asset Management
+
+[Asset Management](/reference/polkadot-hub/assets/){target=\_blank} provides the foundation for on-chain asset management. Create, manage, and transfer fungible tokens and NFTs across the ecosystem. Asset Management offers significantly lower transaction fees—approximately one-tenth of relay chain costs—and reduced deposit requirements, making it ideal for projects managing digital assets at scale. It also enables payment of transaction fees in non-native assets, providing flexibility for developers and users.
### People Chain
@@ -66,13 +70,21 @@ Explore specific Hub functionality through these sections:
--
Learn **Asset Hub**
+-
Learn **Smart Contracts**
+
+ ---
+
+ Deploy Ethereum-compatible smart contracts and build decentralized applications.
+
+ [:octicons-arrow-right-24: Reference](/reference/polkadot-hub/smart-contracts/)
+
+-
Learn **Asset Management**
---
Manage fungible tokens and NFTs with low fees and flexible asset operations.
- [:octicons-arrow-right-24: Reference](/reference/polkadot-hub/assets-and-smart-contracts/)
+ [:octicons-arrow-right-24: Reference](/reference/polkadot-hub/assets/)
-
Learn **People Chain**
From 4af2ded799c5cf4710f3d2f8a2efd5f11acce9ff Mon Sep 17 00:00:00 2001
From: DAWN KELLY
Date: Thu, 20 Nov 2025 14:48:39 -0500
Subject: [PATCH 3/3] grammarly pass
---
reference/polkadot-hub/index.md | 52 +++++++++++++++------------------
1 file changed, 23 insertions(+), 29 deletions(-)
diff --git a/reference/polkadot-hub/index.md b/reference/polkadot-hub/index.md
index 2f09dced5..07cb2a4c9 100644
--- a/reference/polkadot-hub/index.md
+++ b/reference/polkadot-hub/index.md
@@ -6,47 +6,41 @@ categories: Basics, Polkadot Protocol, Polkadot Hub
## Introduction
-Polkadot Hub is the entry point to Polkadot for all users and application developers. It provides access to essential Web3 services including smart contracts, staking, governance, identity management, and cross-ecosystem interoperability—without requiring you to deploy or manage a parachain.
+Polkadot Hub is the entry point for all users and application developers to Polkadot. It provides access to essential Web3 services, including smart contracts, staking, governance, identity management, and cross-ecosystem interoperability—without requiring you to deploy or manage a parachain.
-The Hub encompasses a set of core functionality that enables developers and users to build and interact with applications on Polkadot. Rather than being a single chain, the Hub represents a collection of specialized system parachains and services working together seamlessly to deliver a unified platform experience. This modular approach allows you to interact with different services optimized for specific use cases, all while benefiting from Polkadot's shared security.
+The Hub encompasses a set of core functionality that enables developers and users to build and interact with applications on Polkadot. This specialized system of parachains and services works together seamlessly to deliver a unified platform experience. The modular approach lets you interact with services optimized for specific use cases, while still benefiting from Polkadot's shared security.
-## What the Hub Provides
+## Polkadot Hub Capabilities
-The Polkadot Hub enables a range of essential capabilities:
+Whether you're just getting started or building complex applications, the Hub supports the ability to:
+
+- Hold, send, and receive DOT and other assets across the network.
+- Stake DOT to participate in network security and earn rewards.
+- Vote in governance referendums and shape Polkadot's future.
+- Create both fungible and non-fungible tokens and assets for your projects.
+- Pay transaction fees in any asset, not just DOT.
+- Register as an individual and establish your on-chain identity.
-### Basic User Capabilities
+For more sophisticated development use cases, the Hub enables you to:
-Whether you're just getting started or building complex applications, the Hub supports:
-
-- **Hold, send, and receive DOT** and other assets across the network
-- **Stake DOT** to participate in network security and earn rewards
-- **Vote in governance** referendums and shape Polkadot's future
-- **Create assets** (both fungible tokens and NFTs) for your projects
-- **Pay transaction fees** in any asset, not just DOT
-- **Register as an individual** and establish your on-chain identity
-
-### Advanced Developer Capabilities
-
-For more sophisticated use cases, the Hub enables:
-
-- **Deploy Ethereum-compatible smart contracts** using Solidity or other EVM languages
-- **Build decentralized applications** that leverage Polkadot's security and interoperability
-- **Create and manage fungible tokens and NFTs** with low fees and flexible operations
-- **Manage cross-chain interactions** through XCM messaging with other parachains
-- **Set verified identities** and apply for network opportunities like the Ambassador Program
-- **Join collectives** and participate in governance organizations with specialized roles
+- Deploy Ethereum-compatible smart contracts using Solidity or other EVM languages.
+- Build decentralized applications that leverage Polkadot's security and interoperability.
+- Create and manage fungible tokens and NFTs with low fees and flexible operations.
+- Manage cross-chain interactions through XCM messaging with other parachains.
+- Set verified identities and apply for network opportunities like the Ambassador Program.
+- Join collectives and participate in governance organizations with specialized roles.
## Core Components
-The Polkadot Hub consists of several specialized system parachains and services working together:
+The Polkadot Hub consists of several specialized system parachains and services working together as described in the following sections.
### Smart Contracts
-[Smart Contracts](/reference/polkadot-hub/smart-contracts/){target=\_blank} on Polkadot Hub enable developers to deploy Ethereum-compatible smart contracts using Solidity and other familiar EVM languages. Build decentralized applications with full access to Polkadot's security, interoperability, and cross-chain capabilities. Smart contracts on the Hub benefit from lower fees and integration with native Polkadot features like identity management and asset operations.
+[Smart Contracts](/reference/polkadot-hub/smart-contracts/){target=\_blank} on Polkadot Hub enable developers to deploy Ethereum-compatible smart contracts written in Solidity and other familiar EVM languages. Build decentralized applications with full access to Polkadot's security, interoperability, and cross-chain capabilities. Smart contracts on the Hub benefit from lower fees and integration with native Polkadot features, such as identity management and asset operations.
### Asset Management
-[Asset Management](/reference/polkadot-hub/assets/){target=\_blank} provides the foundation for on-chain asset management. Create, manage, and transfer fungible tokens and NFTs across the ecosystem. Asset Management offers significantly lower transaction fees—approximately one-tenth of relay chain costs—and reduced deposit requirements, making it ideal for projects managing digital assets at scale. It also enables payment of transaction fees in non-native assets, providing flexibility for developers and users.
+[Asset Management](/reference/polkadot-hub/assets/){target=\_blank} provides the foundation for on-chain asset management. Create, manage, and transfer fungible tokens and NFTs across the ecosystem. Asset Management offers significantly lower transaction fees—approximately one-tenth the cost of relay chain transactions—and reduced deposit requirements, making it ideal for projects managing digital assets at scale. It also enables payment of transaction fees in non-native assets, providing developers and users with greater flexibility.
### People Chain
@@ -54,7 +48,7 @@ The Polkadot Hub consists of several specialized system parachains and services
### Bridge Hub
-[Bridge Hub](/reference/polkadot-hub/bridging/){target=\_blank} facilitates trustless interactions between Polkadot and external blockchains like Ethereum and Kusama. Through implementations like Snowbridge, Bridge Hub enables secure cross-chain communication using on-chain light clients and trustless relayers. This component ensures seamless interoperability beyond the Polkadot ecosystem.
+[Bridge Hub](/reference/polkadot-hub/bridging/){target=\_blank} facilitates trustless interactions between Polkadot and external blockchains like Ethereum and Kusama. Through implementations such as Snowbridge, Bridge Hub enables secure cross-chain communication via on-chain light clients and trustless relayers. This component ensures seamless interoperability beyond the Polkadot ecosystem.
### Consensus & Security
@@ -66,7 +60,7 @@ The Polkadot Hub consists of several specialized system parachains and services
## Where to Go Next
-Explore specific Hub functionality through these sections:
+Consider the following resources to explore specific Hub functionality.