Polkadot Wiki

repository·master·Indexed 19 days ago

https://github.com/w3f/polkadot-wiki

The central source of truth for the Polkadot ecosystem maintained by the Web3 Foundation. It provides comprehensive documentation on the Open Source Polkadot Tech Stack, including runtime/parachain frameworks, client libraries across multiple languages, smart contract languages like ink! and Solang, and security tools. The repository is built with MkDocs and features custom RPC macros for real-time blockchain data and Vale for writing consistency.

Tokens
211.2K
Snippets
315
Records
939
Agent score
63%

What's inside Polkadot Wiki

  1. Overview of Polkadot OpenGov Governance

    master

    Polkadot OpenGov is a decentralized governance mechanism where all proposals are initiated by the public. The system uses stake-weighted referenda to agree upon protocol changes. It utilizes WebAssembly (Wasm) for on-chain state-transition functions and supports various voting mechanisms like referenda and batch approval voting.

    Key components include:

    • Proposals: Initiated by the public and subject to a Lead-in period.
    • Tracks: Preset configurations that define the duration of a referendum and the maximum number of simultaneous referenda allowed in that track.
    • Origins: There are 15 distinct origins, each associated with a specific track configuration.
    • Multi-role Delegations: Allows token holders to assign voting power for specific tracks to different expert entities, enabling specialized governance without requiring the holder to be an expert in every domain.
  2. Overview of Polkadot Ecosystem Development Funds

    master

    The Polkadot ecosystem has development funds designed to support the growth of parachains and applications utilizing the Polkadot Tech Stack. Two primary funds are identified:

    • Scytale Digital: A venture initiative focused on strategic investment in Polkadot and Kusama projects. They provide early-stage ventures with mentorship, liquidity, technical advisory, and KPI/OKR oversight.
    • Harbour Industrial Capital (HIC): A Polkadot-focused VC fund managed by Max Rebol and Mario Altenburger, primarily serving family offices and institutional investors.
  3. Overview of Polkadot Multisig Applications

    master

    The Polkadot ecosystem provides several specialized applications to manage multisig (multi-signature) accounts, which allow groups of users to collectively authorize transactions. Key applications include:

    • Mimir: Supports various account types (Flexible, Static, Nested Multisig, and Extension Wallets) and offers real-time transaction synchronization.
    • Multix by Chainsafe: An open-source interface for managing complex multisigs using pure proxies, allowing signatories to adjust thresholds or members without creating new accounts.
    • Nova Spektr: An enterprise-grade multichain wallet supporting 80+ networks, hardware wallets, and light clients with automatic proxy discovery.
    • Polkadot Multisig by Signet: User-friendly software designed for non-technical business users to manage treasury assets, payroll, and organizational identities.
    • Polkasafe: A platform focused on seamless transaction flows (initiate, approve, execute) and simplified extrinsic management for smart contracts and parachains.
  4. Overview of the Open Source Polkadot Stack

    master

    The Polkadot ecosystem consists of several layers of software components used to build, interact with, and secure blockchain networks. This stack includes runtime frameworks, client libraries for various programming languages, RPC gateways, smart contract languages, and specialized tools for testing, indexing, and security.

    Key Layers:

    • Runtime/Parachain Frameworks: The core logic of the blockchain (e.g., Polkadot Blockchain SDK).
    • Client Libraries: Tools to interact with the blockchain from different environments (e.g., TypeScript, Rust, Go, Python, etc.).
    • Smart Contract Languages: Languages used to write logic on top of the runtime (e.g., ink!, Solang, PolkaVM).
    • Testing & Verification: Tools for unit testing, formal verification, and runtime fuzzing.
    • Blockchain Indexing: Engines used to query and organize blockchain data (e.g., Squid SDK, Subquery).
  5. Overview of the Open Source Polkadot Tech Stack

    master

    The Polkadot Tech Stack is a subset of the Web 3.0 Tech Stack, comprising open-source technologies that contribute to or rely on Polkadot. It is designed for decentralized application (Dapp) development across various verticals such as DeFi, Gaming, and Provenance.

    The stack is organized in layers:

    1. Dapps: The top layer including specific use cases like DeFi, Gaming, and Provenance.
    2. Explorers, Wallets: Tools for interacting with the ecosystem.
    3. Tools, APIs, Languages: The developer interface layer.
    4. 2nd layer protocols: Protocols built on top of the base chains.
    5. Chains: The core blockchain layer (e.g., Polkadot).
    6. P2P, Crypto, Wasm: The foundational layer of peer-to-peer networking, cryptography, and WebAssembly.
  6. Use the Polkadot-JS Browser Extension

    master

    The Polkadot-JS Browser Extension (Polkadot Extension) acts as a "virtual vault" to store private keys separately from your browser. It handles address generation and transaction signing.

    Security Note: While more secure than in-browser storage, it is still running on your local computer and is less secure than air-gapped solutions like Parity Signer or hardware wallets (e.g., Ledger).

  7. Understand Polkadot 1.0 Core Innovations

    master

    Polkadot 1.0 (based on Polkadot runtime v1.0.0) is a decentralized computer that utilizes a sharded architecture to provide scalability and security. Key innovations include:

    • Rollup Chains (Parachains): Application-specific blockchains that connect to Polkadot's virtual cores to use its shared security and interoperability.
    • Execution Sharding: Polkadot uses the ELVES security protocol to assign a subset of validators to each virtual core to check incoming rollup data, allowing for parallel processing without compromising security.
    • Shared Security: Rollup chains benefit from Polkadot's Nominated-Proof-of-Stake (NPoS) and ELVES, providing security out-of-the-box.
    • Secure Interoperability: Native communication between rollup chains (and L2s built on them) is enabled via the Cross-Consensus Messaging Format (XCM).
    • Resilient Infrastructure: Supported by an on-chain treasury and OpenGov referendum system to fund network upgrades and development.
    • Fast Development: Built using the modular Substrate framework (part of the Polkadot SDK).
  8. Explore Polkadot Implementations and Tech Stacks

    master

    Polkadot's infrastructure (runtime and host) can be implemented using various programming languages. Key implementations include:

    • Parity Technologies (Rust/Substrate): Uses the Substrate tech stack to implement Polkadot's sharded heterogeneous multi-chain model. This is the primary Rust-based client.
    • ChainSafe Systems (Go): Gossamer is a Go implementation of the Polkadot host.
    • SORAMITSU (C++): Kagome is a C++ implementation of the Polkadot Host, which also includes a C++ libp2p networking layer.
    • Polkadot-JS (JavaScript): A JavaScript client providing tools, interfaces, and libraries for interacting with Polkadot and Substrate.
    • Other Implementations: Includes Golkadot and Polkadot in Java.
  9. Explore the ink! Smart Contract ecosystem

    master

    The ink! ecosystem provides a comprehensive stack for developing, testing, and deploying smart contracts on Polkadot-based chains. The stack is categorized into several functional layers:

    Core Libraries

    • ink!: The primary smart contract language/framework.
    • cargo-contract: Tooling for contract development.
    • pallet-contracts: The Substrate pallet for contract execution.

    Development & Tooling

    • Local Nodes: substrate-contracts-node and Swanky for local testing environments.
    • Smart Contract Development: Tools like DRink!, contracts-ui, OpenBrush, Sol2Ink, and ink-playground for writing and managing contracts.
    • Frontend Development: Libraries such as useink, ink-typegen, and Typechain Polkadot for integrating contracts with web applications.
    • IDE Plugins: ink! Analyzer for enhanced development experience.

    Security, Testing & Governance

    • Security & Testing: ink! Waterfall, Verifier Image for ink!, Patron, and Inkscope Fuzzer.
    • Governance: Abax Governance for decentralized decision-making.
    • Spam Protection: Prosopo for captcha-based protection.

    Specialized Use Cases

    • DeFi: Various AMMs, stablecoins, and DEX contracts (e.g., Panorama Swap, zenlink-dex-contract).
    • Gaming: Projects like Open Emoji Battler.
    • DAO: Frameworks like subDAO and RainbowDAO.
    • Identity/DID: Dotflow.
    • NFT: ArtZero.
    • Oracles: DIA Wasm Oracle.
  10. Explore the Open Source Polkadot Stack

    master

    The Polkadot ecosystem provides various open-source tools categorized by their functional layer. Developers can leverage these tools for blockchain monitoring, gaming integration, no-code development, wallet connectivity, XCM (Cross-Consensus Messaging) operations, and other specialized utilities.

    Available Layers and Tools

    Blockchain/Event Monitoring

    Tools for tracking events and monitoring blockchain state:

    Gaming

    SDKs and tools for integrating Polkadot into game engines:

    No-code Platforms

    Visual programming and plugin tools for non-developers:

    Wallets

    Connectivity and management tools for wallet integration:

    XCM (Cross-Consensus Messaging)

    Tools for managing and monitoring XCM operations:

    Other Utilities

    Specialized libraries and tools:

  11. Understand Polkadot Ecosystem Terms

    master

    The Polkadot Wiki Glossary provides definitions for core concepts used throughout the ecosystem. Key categories include:

    • Consensus & Finality: Terms like BABE (block production), GRANDPA (finality gadget), Aura (authority-based scheduling), and Attestation (validity messages).
    • Staking & Validation: Concepts such as Active Nomination, Authority, Bonding, Commission, and Era (the period for recalculating validator sets).
    • Parachain Architecture: Terms including Availability Cores, Collator, Collations, Coretime, Bridge, and Candidate (a submitted parachain block).
    • Governance: Mechanisms like Governance Council, Bounty, Community Queue, and External Queue (for proposals).
    • Data & Protocol: Definitions for Block, Blockspace, Extrinsic (SCALE encoded state changes), Genesis (block 0), and Bitfield Array.
  12. Pros and Cons of Staking

    master

    Pros

    • Earn rewards: Contribute to network security and earn a portion of the ~85% annual inflation.
    • Low barrier to entry: Use Nomination Pools to participate with smaller amounts.
    • Decentralization: Ability to choose multiple validators via the NPoS system.

    Cons

    • Locked liquidity: Tokens are locked during the unbonding period. You cannot use them for crowdloans or transfers while unbonding.
    • Slashing risk: You may be punished if your active validator misbehaves.
    • No rewards during unbonding: You earn nothing while your tokens are in the unbonding phase.