You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
- Summary: Learn about Polkadot's technical architecture, governance framework, parachain ecosystem, and the tools you need to build and interact with the network.
1250
+
1251
+
## Introduction
1252
+
1253
+
The Technical Reference section provides comprehensive documentation of Polkadot's architecture, core concepts, and development tooling. Whether you're exploring how Polkadot's relay chain coordinates parachains, understanding governance mechanisms, or building applications on the network, this reference covers the technical foundations you need.
1254
+
1255
+
Polkadot is a multi-chain network that enables diverse, interconnected blockchains to share security and communicate seamlessly. Understanding how these components interact from the [relay chain](/polkadot-protocol/glossary#relay-chain){target=\_blank} that validates [parachains](/polkadot-protocol/glossary#parachain){target=\_blank} to the [governance](/reference/glossary#governance){target=\_blank} mechanisms that evolve the protocol is essential for developers, validators, and network participants.
1256
+
1257
+
This guide organizes technical documentation across five core areas: Polkadot Hub, Parachains, On-Chain Governance, Glossary, and Tools, each providing detailed information on different aspects of the Polkadot ecosystem.
1258
+
1259
+
## Polkadot Hub
1260
+
1261
+
[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.
1262
+
1263
+
The Hub encompasses a set of core functionality that enables developers and users to build and interact with applications on Polkadot. Key capabilities include:
1264
+
1265
+
-**Smart contracts**: Deploy Ethereum-compatible smart contracts and build decentralized applications.
1266
+
-**Assets and tokens**: Create, manage, and transfer fungible tokens and NFTs across the ecosystem.
1267
+
-**Staking**: Participate in network security and earn rewards by staking DOT.
1268
+
-**Governance**: Vote on proposals and participate in Polkadot's decentralized decision-making through OpenGov.
1269
+
-**Identity services**: Register and manage on-chain identities, enabling access to governance roles and network opportunities.
1270
+
-**Cross-chain interoperability**: Leverage XCM messaging to interact securely with other chains in the Polkadot ecosystem.
1271
+
-**Collectives and DAOs**: Participate in governance collectives and decentralized autonomous organizations.
1272
+
1273
+
## Parachains
1274
+
1275
+
[Parachains](/reference/parachains/){target=\_blank} are specialized blockchains that connect to the Polkadot relay chain, inheriting its security while maintaining their own application-specific logic. The parachains documentation covers:
1276
+
1277
+
-**Accounts**: Deep dive into account types, storage, and management on parachains.
1278
+
-**Blocks, transactions and fees**: Understand block production, transaction inclusion, and fee mechanisms.
1279
+
-**Consensus**: Learn how parachain blocks are validated and finalized through the relay chain's consensus.
1280
+
-**Chain data**: Explore data structures, storage layouts, and state management.
1281
+
-**Cryptography**: Study cryptographic primitives used in Polkadot SDK-based chains.
1282
+
-**Data encoding**: Understand how data is encoded and decoded for blockchain compatibility.
1283
+
-**Networks**: Learn about networking protocols and peer-to-peer communication.
1284
+
-**Interoperability**: Discover [Cross-Consensus Messaging (XCM)](/parachains/interoperability/get-started/){target=\_blank}, the standard for cross-chain communication.
1285
+
-**Randomness**: Understand how randomness is generated and used in Polkadot chains.
1286
+
-**Node and runtime**: Learn about parachain nodes, runtime environments, and the [Polkadot SDK](https://github.com/paritytech/polkadot-sdk){target=\_blank}.
1287
+
1288
+
## On-Chain Governance
1289
+
1290
+
[On-Chain governance](/reference/governance/){target=\_blank} is the decentralized decision-making mechanism for the Polkadot network. It manages the evolution and modification of the network's runtime logic, enabling community oversight and approval for proposed changes. The governance documentation details:
1291
+
1292
+
-**OpenGov framework**: Understand Polkadot's next-generation governance system with enhanced delegation, flexible tracks, and simultaneous referendums.
1293
+
-**Origins and tracks**: Learn how governance proposals are categorized, prioritized, and executed based on their privilege level and complexity.
1294
+
-**Voting and delegation**: Explore conviction voting, vote delegation, and how token holders participate in governance.
1295
+
-**Governance evolution**: See how Polkadot's governance has evolved from Governance V1 to the current OpenGov system.
1296
+
1297
+
## Glossary
1298
+
1299
+
The [Glossary](/reference/glossary/){target=\_blank} provides quick-reference definitions for Polkadot-specific terminology. Essential terms include:
The [Tools](/reference/tools/){target=\_blank} section documents essential development and interaction tools for the Polkadot ecosystem:
1310
+
1311
+
-**Light clients**: Lightweight solutions for interacting with the network without running full nodes.
1312
+
-**JavaScript/TypeScript tools**: Libraries like [Polkadot.js API](/reference/tools/polkadot-js-api/){target=\_blank} and [PAPI](/reference/tools/papi/){target=\_blank} for building applications.
1313
+
-**Rust tools**: [Polkadart](/reference/tools/polkadart/){target=\_blank} and other Rust-based libraries for SDK development.
1314
+
-**Python tools**: [py-substrate-interface](/reference/tools/py-substrate-interface/){target=\_blank} for Python developers.
1315
+
-**Testing and development**: Tools like [Moonwall](/reference/tools/moonwall/){target=\_blank}, [Chopsticks](/reference/tools/chopsticks/){target=\_blank}, and [Omninode](/reference/tools/omninode/){target=\_blank} for smart contract and parachain testing.
1316
+
-**Indexing and monitoring**: [Sidecar](/reference/tools/sidecar/){target=\_blank} for data indexing and [Dedot](/reference/tools/dedot/){target=\_blank} for substrate interaction.
1317
+
-**Cross-chain tools**: [ParaSpell](/reference/tools/paraspell/){target=\_blank} for XCM integration and asset transfers.
1318
+
1319
+
## Where to Go Next
1320
+
1321
+
For detailed exploration of specific areas, proceed to any of the main sections:
0 commit comments