diff --git a/docs/general/decentralized-voices.md b/docs/general/decentralized-voices.md index 43791e707c9..1f5a931d1d8 100644 --- a/docs/general/decentralized-voices.md +++ b/docs/general/decentralized-voices.md @@ -7,10 +7,10 @@ keywords: [community, ecosystem, governance, decentralized voices, delegations] slug: ../decentralized-voices --- -The Decentralized Voices program for {{ polkadot: Polkadot :polkadot }}{{ kusama: Kusama :kusama }} -empowers broader community participation in [Polkadot OpenGov](../learn/learn-polkadot-opengov.md) -by [delegating](../learn/learn-polkadot-opengov.md#multirole-delegation) -{{ polkadot: 42 Million DOT :polkadot }}{{ kusama: 180,000 KSM :kusama }} of voting power. +The Decentralized Voices program empowers broader community participation in +[Polkadot OpenGov](../learn/learn-polkadot-opengov.md) by +[delegating](../learn/learn-polkadot-opengov.md#multirole-delegation) 42 Million DOT and 80,000 KSM +of voting power. ## Decentralized Votes @@ -19,8 +19,7 @@ Building on the success of previous initiatives like [the Decentralized Futures Program](./decentralized-futures.md), Web3 Foundation is working on decentralizing governance within the Polkadot ecosystem to ensure a fair decision-making process. In line with the Foundation's ethos, this program seeks to amplify the voices of passionate and -knowledgeable participants who may lack significant -{{ polkadot: DOT :polkadot }}{{ kusama: KSM :kusama }} holdings, aiming to mitigate potential +knowledgeable participants who may lack significant holdings, aiming to mitigate potential marginalization. This initiative does not impact existing programs like the Thousand Validators Program, as [the tokens allocated can be used for both staking and governance](../learn/learn-polkadot-opengov.md#voluntary-locking-conviction-voting). @@ -31,8 +30,7 @@ Please fill out [this application](https://docs.google.com/forms/d/e/1FAIpQLSeIFOhMfoqRoeYqr1c_-UeB2a6u0YEsi9CaNEEeUAXtN0oE3w/viewform) provided by Web3 Foundation. Information requested in the form includes the following: -- The {{ polkadot: Polkadot :polkadot }}{{ kusama: Kusama :kusama }} address to which you would like - to have {{ polkadot: DOT :polkadot }}{{ kusama: KSM :kusama }} delegated. This account must have a +- The account address to which you would like to have DOT or KSM delegated. This account must have a verified identity, including at least one of the following fields: X (formerly Twitter), Matrix (Element), or email. - A link to a _publicly accessible_ declaration of your Polkadot “political philosophy” and/or diff --git a/docs/general/faq.md b/docs/general/faq.md index daa15478f48..fc741417276 100644 --- a/docs/general/faq.md +++ b/docs/general/faq.md @@ -84,7 +84,7 @@ There is no central authority that decides on validators, so there is not per se that you can fill out. Registering as a validator is permissionless; in order to become one you must only set up a validator node and mark your intention to validate on chain. For detailed instruction on how to do validate you can consult the -{{ polkadot: [Polkadot validator guide](../maintain/maintain-guides-how-to-validate-polkadot.md) :polkadot }}{{ kusama: [Kusama validator guide](../maintain/kusama/maintain-guides-how-to-validate-kusama.md) :kusama }}. +[validator guide](../maintain/maintain-guides-how-to-validate-polkadot.md). However, once you've set up a validator and have registered your intention it does not mean that you will be included in the _active set_ right away. The validators are elected to the active set based diff --git a/docs/general/glossary.md b/docs/general/glossary.md index 789c9e847ba..50be0ec9395 100644 --- a/docs/general/glossary.md +++ b/docs/general/glossary.md @@ -25,9 +25,8 @@ A system parachain used for asset management. ## Attestation -In the {{ polkadot: Polkadot :polkadot }}{{ kusama: Kusama :kusama }} validity system, an -_attestation_ is a type of message that validators broadcast that says whether they think a -parachain candidate block is valid or invalid. +In the network's validity system, an _attestation_ is a type of message that validators broadcast +that says whether they think a parachain candidate block is valid or invalid. ## Auction (Parachain) @@ -43,7 +42,7 @@ a known set of authorities take turns producing blocks. An authority is a generic term for the role in a blockchain that can participate in the consensus mechanisms. In [GRANDPA](#grandpa-finality-gadget), the authorities vote on chains they consider final. In BABE, the authorities are block producers. Authority sets can be chosen to be mechanisms -such as {{ polkadot: Polkadot :polkadot }}{{ kusama: Kusama :kusama }}'s NPoS algorithm. +such as Polkadot's NPoS algorithm. ## Availability Cores @@ -53,8 +52,7 @@ appropriate Runtime API. ## BABE -Blind Assignment for Blockchain Extension (BABE) is -{{ polkadot: Polkadot :polkadot }}{{ kusama: Kusama :kusama }}'s block production mechanism. +Blind Assignment for Blockchain Extension (BABE) is Polkadot's block production mechanism. ## Bitfield Array @@ -98,22 +96,19 @@ A process by which tokens can be "frozen" in exchange for some other benefit. Fo is a form of bonding for which you receive rewards in exchange for securing the network. You can also bond tokens in exchange for a parachain slot. -## Bounty +## [Bounty](../learn/learn-polkadot-opengov-treasury.md#bounties) -A mechanism which works in some sense as the reverse of a Treasury Proposal, allowing the -{{ polkadot: Polkadot :polkadot }}{{ kusama: Kusama :kusama }} Council to indicate that there is a -need to do some task for the {{ polkadot: Polkadot :polkadot }}{{ kusama: Kusama :kusama }} network -and allowing users to receive DOT in return for working on that task. +A mechanism that allows network participants to access treasury funding without going through the +process of submitting an OpenGov referendum. Note that a bounty got funds through OpenGov in the +first place, but the subsequent disbursement of those funds is controlled by curators based on +achieved milestones by the recipient. ## Bridge -A parachain that acts as an intermediary between the -{{ polkadot: Polkadot :polkadot }}{{ kusama: Kusama :kusama }} Relay Chain and an external chain, in -such a way that it appears to the Relay Chain that the external chain is a parachain (i.e., meets -the {{ polkadot: Polkadot :polkadot }}{{ kusama: Kusama :kusama }} Host's requirements of -parachains). Bridges allow for interaction between other blockchains, such as Ethereum and Bitcoin, -that are not natively compatible with -{{ polkadot: Polkadot :polkadot }}{{ kusama: Kusama :kusama }}. +A parachain that acts as an intermediary between the Relay Chain and an external chain, in such a +way that it appears to the Relay Chain that the external chain is a parachain (i.e., meets the +network Host's requirements of parachains). Bridges allow for interaction between other blockchains, +such as Ethereum and Bitcoin, that are not natively compatible with the Relay Chain. ## Byzantine Fault Tolerance @@ -134,8 +129,7 @@ being referred to as a candidate as soon it has been finalized. ## Collations -Parachain blocks or candidates that are being proposed to the -{{ polkadot: Polkadot :polkadot }}{{ kusama: Kusama :kusama }} relay chain validators. More +Parachain blocks or candidates that are being proposed to the Relay Chain validators. More specifically, a collation is a [data structure](https://spec.polkadot.network/#defn-collation) which contains the proposed parachain candidate, including an optional validation parachain Runtime update and upward messages. @@ -173,8 +167,7 @@ waiting to become referenda. Compare the External queue. The process of a group of entities to agree on a particular data value (such as the ordering and makeup of blocks on a blockchain). There are a variety of algorithms used for determining consensus. -The consensus algorithm used by {{ polkadot: Polkadot :polkadot }}{{ kusama: Kusama :kusama }} is -[GRANDPA](#grandpa-finality-gadget). +The consensus algorithm used by Polkadot is [GRANDPA](#grandpa-finality-gadget). ## Crowdloan @@ -224,9 +217,8 @@ conflicting chains. ## External Queue -The queue for proposals originating with the -{{ polkadot: Polkadot :polkadot }}{{ kusama: Kusama :kusama }} Council which are waiting to become -referenda. Compare the Community queue. +**Not applicable to OpenGov.** The queue for proposals originating with the Council which are +waiting to become referenda. Compare the Community queue. ## Extrinsic @@ -245,9 +237,8 @@ contain the technical knowledge base of the Kusama and/or Polkadot networks and ## Finality The property of a block that cannot be reverted. Generally, created blocks are not final until some -point in the future - perhaps never, in the case of "probabilistic finality". The -{{ polkadot: Polkadot :polkadot }}{{ kusama: Kusama :kusama }} Relay Chain uses a deterministic -finality gadget known as [GRANDPA](#grandpa-finality-gadget). +point in the future - perhaps never, in the case of "probabilistic finality". The Relay Chain uses a +deterministic finality gadget known as [GRANDPA](#grandpa-finality-gadget). ## Finality Gadget @@ -271,9 +262,7 @@ In the _genesis_ state Alice, Bob, and Charlie had 30 tokens each. ## Governance The process of determining what changes to the network are permissible, such as modifications to -code or movement of funds. The governance system in -{{ polkadot: Polkadot :polkadot }}{{ kusama: Kusama :kusama }} is on-chain and revolves around -stakeholder voting. +code or movement of funds. The governance system is on-chain and revolves around stakeholder voting. ## Governance Council @@ -284,10 +273,9 @@ group to vote on and cancelling malicious referenda. ## GRANDPA Finality Gadget -GHOST-based Recursive ANcestor Deriving Prefix Agreement. It is the finality gadget for -{{ polkadot: Polkadot, :polkadot }}{{ kusama: Kusama, :kusama }} which allows asynchronous, -accountable, and safe finality to the blockchain. For an overview of GRANDPA, see -[this Medium post](https://medium.com/polkadot-network/polkadot-proof-of-concept-3-a-better-consensus-algorithm-e81c380a2372) +GHOST-based Recursive ANcestor Deriving Prefix Agreement. It is the finality gadget allows +asynchronous, accountable, and safe finality to the blockchain. For an overview of GRANDPA, see +[this Medium post](https://medium.com/polkadot-network/polkadot-proof-of-concept-3-a-better-consensus-algorithm-e81c380a2372). ## Hard Fork @@ -370,14 +358,14 @@ Short for "main network": the fully functional and acting chain that runs its ow ## Message -In {{ polkadot: Polkadot :polkadot }}{{ kusama: Kusama :kusama }}'s XCMP protocol, a _message_ is -arbitrary data that is sent from one parachain (the egress chain) to another (the ingress chain) -through a channel and ensured delivery by the validator set. +In Polkadot's XCMP protocol, a _message_ is arbitrary data that is sent from one parachain (the +egress chain) to another (the ingress chain) through a channel and ensured delivery by the validator +set. ## Message Queue -In {{ polkadot: Polkadot :polkadot }}{{ kusama: Kusama :kusama }}'s XCMP protocol, a _message queue_ -is the list of messages waiting to be processed by a particular receiving parachain over a channel. +In Polkadot's XCMP protocol, a _message queue_ is the list of messages waiting to be processed by a +particular receiving parachain over a channel. ## Metadata @@ -405,9 +393,8 @@ the good behavior of the validator. Nominated Proof-of-Stake differs from the mo Delegated Proof-of-Stake in that nominators are subject to loss of stake if they nominate a bad validator; delegators are not subject to loss of stake based on the behavior of the validator. Note that some other blockchain technologies may use the term Delegated Proof-of-Stake, even if -delegators can be [slashed](../learn/learn-offenses.md). -{{ polkadot: Polkadot :polkadot }}{{ kusama: Kusama :kusama }} uses the Phragmén method to allocate -stake to nominees. +delegators can be [slashed](../learn/learn-offenses.md). Polkadot uses the Phragmén method to +allocate stake to nominees. ## Nominator @@ -437,9 +424,8 @@ both Kusama and Polkadot. ## Origin The initiator of an extrinsic. A simple origin would be the account that is sending a token to -another account. {{ polkadot: Polkadot :polkadot }}{{ kusama: Kusama :kusama }} also supports more -complex origin types, such as the [root origin](#root-origin), from which privileged functions can -be called. +another account. Polkadot also supports more complex origin types, such as the +[root origin](#root-origin), from which privileged functions can be called. ## Pallet @@ -448,14 +434,13 @@ A [Substrate](#substrate) runtime module. ## Parachain A blockchain that meets several characteristics that allow it to work within the confines of the -{{ polkadot: Polkadot :polkadot }}{{ kusama: Kusama :kusama }} Host. Also known as "parallelized -chain". All parachains start their life-cycle as a parathread. +network Host. Also known as "parallelized chain". All parachains start their life-cycle as a +parathread. ## Parachain Development Kit (PDK) Similar to an [SDK](#sdk), parachain development kits (PDK) is a set of tools that make it easy for -developers to create {{ polkadot: Polkadot :polkadot }}{{ kusama: Kusama :kusama }} compatible -[parachains](#parachain). +developers to create Polkadot-compatible [parachains](#parachain). ## ParaID @@ -465,9 +450,8 @@ A unique numeric (non-negative integer) identifier for a parachain. Historically, the term "parathread" has been used in two contexts: a chain registered with a `ParaID` on the [relay chain](#relay-chain) that has not yet become a parachain (i.e. not connected -to a {{ polkadot: Polkadot :polkadot }}{{ kusama: Kusama :kusama }} core), or as an on-demand -parachain (i.e. a parachain using on-demand coretime) which does not produce blocks at regular -intervals. +to a Relay Chain core), or as an on-demand parachain (i.e. a parachain using on-demand coretime) +which does not produce blocks at regular intervals. ## Parachain Registry @@ -498,15 +482,13 @@ standards and expose bad actors within the ecosystems of Polkadot. ## Host -The environment in which a runtime module can be executed. Parachains must support the -{{ polkadot: Polkadot :polkadot }}{{ kusama: Kusama :kusama }} Host - external chains that do not -will have to use a bridge. Previously known as the -{{ polkadot: Polkadot :polkadot }}{{ kusama: Kusama :kusama }} Runtime Environment. +The environment in which a runtime module can be executed. Parachains must support the network +Host - external chains that do not will have to use a bridge. Previously known as the Polkadot +Runtime Environment. ## Runtime Environment -The previous name for the {{ polkadot: Polkadot :polkadot }}{{ kusama: Kusama :kusama }} -[Host](#polkadot-host). +The previous name for the Polkadot [Host](#polkadot-host). ## Paseo @@ -543,9 +525,8 @@ Proof-of-Work system can have any number of participants. ## Proposal -A potential function call to be voted on in a referendum. Proposals modify the behavior of the -{{ polkadot: Polkadot :polkadot }}{{ kusama: Kusama :kusama }} network, from minor parameter tuning -up to replacing the runtime code. +A potential function call to be voted on in a referendum. Proposals can modify the behavior of the +network, from minor parameter tuning up to replacing the runtime code. ## Protocol @@ -556,8 +537,7 @@ and possible recovery methods. ## Random Seed A random seed is a pseudo-random number available on-chain. It is used in various places of the -{{ polkadot: Polkadot :polkadot }}{{ kusama: Kusama :kusama }} protocol, most prominently in -[BABE](#babe) the block production mechanism. +protocol, most prominently in [BABE](#babe), the block production mechanism. ## Referendum @@ -638,11 +618,9 @@ Hot keys that are used for performing network operations by validators, for exam ## Shared Security -The security model that {{ polkadot: Polkadot :polkadot }}{{ kusama: Kusama :kusama }} uses whereby -all chains are equally secured. This is achieved by placing proofs of the validity of parachain -blocks into the Relay Chain such that, in order to revert finality of a single parachain, an -attacker would need to attack the entire -{{ polkadot: Polkadot :polkadot }}{{ kusama: Kusama :kusama }} system. +The security model used whereby all chains are equally secured. This is achieved by placing proofs +of the validity of parachain blocks into the Relay Chain such that, in order to revert finality of a +single parachain, an attacker would need to attack the entire system. ## Slashing @@ -669,10 +647,9 @@ sent to the beneficiary account at the end of the spend period. ## Staking -The act of bonding tokens for {{ polkadot: Polkadot (DOT) :polkadot }} -{{ kusama: Kusama (KSM) :kusama }} by putting them up as "collateral" for a chance to produce a -valid block (and thus obtain a block reward). Validators and nominators stake their -{{ polkadot: DOT :polkadot }} {{ kusama: KSM :kusama }} in order to secure the network. +The act of bonding tokens by putting them up as "collateral" for a chance to produce a valid block +(and thus obtain a block reward). Validators and nominators stake their tokens in order to secure +the network. ## State transition function @@ -681,8 +658,7 @@ describe how tokens can be transferred from one account to another. ## Substrate -A modular framework for building blockchains. -{{ polkadot: Polkadot :polkadot }}{{ kusama: Kusama :kusama }} is built using +A modular framework for building blockchains. Polkadot is built using [Substrate](https://substrate.io/). Chains built with Substrate will be easy to connect as parachains. For developers, see the [Substrate GitHub repository](https://github.com/paritytech/polkadot-sdk/tree/master/substrate). @@ -696,9 +672,8 @@ core by governance rather than by auction. Examples of system parachains include ## Tabling -In {{ polkadot: Polkadot :polkadot }}{{ kusama: Kusama :kusama }} governance, bringing a proposal to -a vote via referendum. Note that this is the British meaning of "tabling", which is different from -the US version, which means "to postpone" a measure. +In governance, bringing a proposal to a vote via referendum. Note that this is the British meaning +of "tabling", which is different from the US version, which means "to postpone" a measure. ## Teleport @@ -769,8 +744,8 @@ get into the active set in a future era, this may turn into an active or inactiv ## Wallet -A program that allows one to store private keys and sign transactions for -{{ polkadot: Polkadot :polkadot }}{{ kusama: Kusama :kusama }} or other blockchain networks. +A program that allows one to store private keys and sign transactions for Polkadot or other +blockchain networks. ## Wasm @@ -791,8 +766,7 @@ methods to safeguard decentralization, to the benefit and for the stability of t ## WebAssembly -An instruction format for a virtual, stack-based machine. -{{ polkadot: Polkadot :polkadot }}{{ kusama: Kusama :kusama }} Runtime Modules are compiled to +An instruction format for a virtual, stack-based machine. Polkadot Runtime Modules are compiled to WebAssembly. Also known as Wasm. ## Weights diff --git a/docs/general/how-to-dyor.md b/docs/general/how-to-dyor.md index d5f111b3fb2..40de479c3da 100644 --- a/docs/general/how-to-dyor.md +++ b/docs/general/how-to-dyor.md @@ -47,12 +47,10 @@ have delivered all of their milestones, then their code is most likely of reason Furthermore, Web3 Foundation is not the only entity in the ecosystem that provides grants. Other reputable teams in the ecosystem that have developed platforms or prospective parachains provide grants for projects to build on or expand their project. These are also indicators that a project is -committed to building on the broader {{ polkadot: Polkadot :Polkadot }}{{ kusama: Kusama :kusama }} -ecosystem. +committed to building on the broader Polkadot ecosystem. -Receiving funding from reputable VCs and are known to be involved with other reputable -{{ polkadot: Polkadot :Polkadot }}{{ kusama: Kusama :kusama }} projects can also be a good -indicator. Or participating in the +Receiving funding from reputable VCs and are known to be involved with other reputable Polkadot +projects can also be a good indicator. Or participating in the [Polkadot Alpha Program](https://polkadot.network/development/alpha/). **However**, claiming such associations and having them is not always the same thing. **You always @@ -168,21 +166,17 @@ community, providing guidance and answers, which is always a good sign. But if the team are ghosts that do not show up anywhere and only engage with the community through proxies, this can be considered a red flag and extra precaution should be taken. -Besides their community, projects that are serious about building on -{{ polkadot: Polkadot :Polkadot }}{{ kusama: Kusama :kusama }} usually engage with the broader -{{ polkadot: Polkadot :Polkadot }}{{ kusama: Kusama :kusama }} community. They are active in the -various [Polkadot and Kusama channels](https://wiki.polkadot.network/docs/community/), and some of -them are [Polkadot Ambassadors](https://polkadot.network/polkadot-ambassador-program/), or generally +Besides their community, projects that are serious about building on Polkadot usually engage with +the [community](./community.md). They are active in the various +[Polkadot and Kusama channels](https://wiki.polkadot.network/docs/community/), and some of them are +[Polkadot Ambassadors](https://polkadot.network/polkadot-ambassador-program/), or generally prominent members of the ecosystem. ### Clear Integration -There are many ways for a project to build on -{{ polkadot: Polkadot :Polkadot }}{{ kusama: Kusama :kusama }}. Perhaps the most direct one is to -aim to become a parachain. Some of the most notable -{{ polkadot: Polkadot :Polkadot }}{{ kusama: Kusama :kusama }} projects are already parachains on -Kusama or gearing up to become one, and most of them may also bid for Polkadot parachain slots when -live. +There are many ways for a project to build on Polkadot. Perhaps the most direct one is to aim to +become a parachain. Some of the most notable Polkadot projects are already parachains on Kusama or +gearing up to become one, and most of them may also bid for Polkadot parachain slots when live. Of course, getting a parachain slot on either of the two main networks is not guaranteed, and all projects will need to win an [auction](https://kusama.network/auctions/) for a parachain slot. @@ -201,16 +195,13 @@ parachain. Some use it simply because of its infrastructure to build their custo any plans to connect to the Relay Chain. And other projects may aim to become a parachain only on Kusama or directly on Polkadot. -However, building a potential parachain is not the only way to build on -{{ polkadot: Polkadot :Polkadot }}{{ kusama: Kusama :kusama }} and expand its ecosystem. A project -might aim to build a DeFi platform on a parachain, launch a stablecoin or other token on the Asset -Hub, build a decentralized exchange, or any other dApp that one might think of, without ever -touching the Relay Chain. And that's the beauty of -{{ polkadot: Polkadot! :Polkadot }}{{ kusama: Kusama! :kusama }} +However, building a potential parachain is not the only way to build on Polkadot and expand its +ecosystem. A project might aim to build a DeFi platform on a parachain, launch a stablecoin or other +token on the Asset Hub, build a decentralized exchange, or any other dApp that one might think of, +without ever touching the Relay Chain. -But in all of those cases, their plans to build on -{{ polkadot: Polkadot, :Polkadot }}{{ kusama: Kusama, :kusama }} whatever they may be, should be -clearly stated on their site and in their documentation. Most importantly, you should look for an +But in all of those cases, their plans to build on Polkadot whatever they may be, should be clearly +stated on their site and in their documentation. Most importantly, you should look for an explanation of _how_ they plan to achieve that integration. A roadmap that places the integration at some point in the future means close to nothing without clearly stating the steps to get there. These plans should be evaluated in tandem with your research on the technical expertise of the team. @@ -219,9 +210,8 @@ This is especially true for projects that are already running on another network or Binance Smart Chain, and have issued tokens there. Many projects do that either to raise funds and test their infrastructure or because they aim to build a "multi-chain" solution or both. But because those projects are not currently built on Substrate, the existence of a clear and robust -integration plan with {{ polkadot: Polkadot :Polkadot }}{{ kusama: Kusama :kusama }} should be -essential in your research to ensure that they will indeed build on -{{ polkadot: Polkadot :Polkadot }}{{ kusama: Kusama :kusama }} one day. +integration plan with the Relay Chain should be essential in your research to ensure that they will +indeed build on it one day. ## _Soft_ metrics diff --git a/docs/general/ledger.md b/docs/general/ledger.md index 70ce372ca71..f7137e77ee4 100644 --- a/docs/general/ledger.md +++ b/docs/general/ledger.md @@ -12,11 +12,10 @@ import MessageBox from "../../components/MessageBox"; import "../../components/M -The {{ polkadot: Polkadot :polkadot }}{{ kusama: Kusama :kusama }} [Ledger](https://www.ledger.com/) -application is compatible with the Ledger Nano S, Nano X, and Stax devices. Ledger devices are -hardware wallets that keep your secret key secured on a physical device that does not expose it to -your computer or the internet. The private keys will not be exposed even if you connect your Ledger -device via USB to your computer. +The Polkadot [Ledger](https://www.ledger.com/) application is compatible with the Ledger Nano S, +Nano X, and Stax devices. Ledger devices are hardware wallets that keep your secret key secured on a +physical device that does not expose it to your computer or the internet. The private keys will not +be exposed even if you connect your Ledger device via USB to your computer. Ledger devices are hierarchical deterministic wallets (HD wallets), where: @@ -55,16 +54,13 @@ More information on Ledger device comparisons ## Requirements -Here is a list of what you will need before using -{{ polkadot: Polkadot :polkadot }}{{ kusama: Kusama :kusama }} with Ledger: +Here is a list of what you will need before using Polkadot with Ledger: -- A Ledger Nano X, Stax, or Nano S plus (recommended for - {{ polkadot: Polkadot :polkadot }}{{ kusama: Kusama :kusama }} Ledger App space requirements and - functionalities). +- A Ledger Nano X, Stax, or Nano S plus (recommended for the Polkadot Ledger App space requirements + and functionalities). - [Ledger Live](https://www.ledger.com/ledger-live) installed and up-to-date. -- The latest firmware of the {{ polkadot: Polkadot :polkadot }}{{ kusama: Kusama :kusama }} Ledger - App installed (always check for updates in Ledger Live under the "Manager" tab; you will need to - allow access with your nano). +- The latest firmware of the Polkadot Ledger App installed (always check for updates in Ledger Live + under the "Manager" tab; you will need to allow access with your nano). - A Chromium-based web browser if you use a browser extension. Ledger devices are tiny computers. They have an operating system (or firmware), and on top of it, @@ -76,17 +72,14 @@ devices. Make sure you have your Ledger devices with firmware and apps up-to-dat Ledger devices can be equipped with applications that are blockchain-specific. Third parties usually develop such applications, enabling users to transact securely on the blockchain network. Polkadot Ledger apps are developed by [Zondax](https://zondax.ch/) and are available -[here](https://github.com/Zondax/ledger-polkadot). The Polkadot Ledger applications allow you to -manage {{ polkadot: Polkadot's :polkadot }}{{ kusama: Kusama's :kusama }} native token, -{{ polkadot: DOT :polkadot }}{{ kusama: KSM :kusama }}, and more depending on the version of the -app. +[here](https://github.com/Zondax/ledger-polkadot). The Polkadot Ledger application allows you to +manage Polkadot, Kusama and their parachains native tokens. :::note Ledger apps may not support all the transactions -Check the -{{ polkadot: [Ledger Polkadot App](https://github.com/Zondax/ledger-polkadot) :polkadot }}{{ kusama: [Ledger Kusama App](https://github.com/Zondax/ledger-kusama) :kusama }} -specification for the list of transactions supported. Some transactions are supported only on a -specific app version, and others are not supported by any version. For instance, joining a +Check the [Ledger Polkadot App](https://github.com/Zondax/ledger-polkadot) specification for the +list of transactions supported. Some transactions are supported only on a specific app version, and +others are not supported by any version. For instance, joining a [nomination pool](../learn/learn-nomination-pools.md) is only possible with the **XL version** but not on the **lite version**. @@ -167,7 +160,7 @@ the new account, and stake again. See [this support article](https://support.polkadot.network/support/solutions/articles/65000175822-how-to-use-polkadot-and-stake-with-ledger-live) -to learn how to use {{ polkadot: Polkadot :polkadot }}{{ kusama: Kusama :kusama }} with ledger live. +to learn how to use Polkadot with ledger live. --- diff --git a/docs/general/polkadotjs.md b/docs/general/polkadotjs.md index 0b73c4f2ce1..cae4b8a751a 100644 --- a/docs/general/polkadotjs.md +++ b/docs/general/polkadotjs.md @@ -14,10 +14,10 @@ import MessageBox from "../../components/MessageBox"; import "../../components/M [Polkadot Support Team](https://support.polkadot.network/support/home). For more user-friendly tools see the [wallets](./wallets-index), [apps](./apps-index) and [dashboard](./dashboards-index) pages." /> -[**Polkadot-JS**](https://polkadot.js.org/) is a collection of tools that interfaces with the -{{ polkadot: Polkadot :polkadot }}{{ kusama: Kusama :kusama }} blockchain in a granular way. Below -we describe the different components of Polkadot-JS. For more information about Polkadot-JS you can -consult the [**official documentation**](https://polkadot.js.org/docs/). +[**Polkadot-JS**](https://polkadot.js.org/) is a collection of tools that interfaces with Relay +Chains and parachains in a granular way. Below we describe the different components of Polkadot-JS. +For more information about Polkadot-JS you can consult the +[**official documentation**](https://polkadot.js.org/docs/). ## Polkadot-JS UI @@ -100,8 +100,7 @@ address. ## Polkadot-JS API The [**Polkadot-JS API**](https://github.com/polkadot-js/api) is a JavaScript API allowing for -programs to interface with the functionalities of -{{ polkadot: Polkadot. :polkadot }}{{ kusama: Kusama. :kusama }} +programs to interface with the functionalities of Polkadot. While interacting with the underlying [**@polkadot/api**](https://www.npmjs.com/package/@polkadot/api), most interfaces are generated @@ -134,10 +133,9 @@ comes down to either [**querying on-chain data**](#querying-on-chain-data) or ### Querying On-chain Data -To populate the Apps UI, the web app queries the Polkadot-JS API. The API then queries a -{{ polkadot: Polkadot :polkadot }}{{ kusama: Kusama :kusama }} node and uses JavaScript to return -information that the UI will display on the screen. You can choose which node to connect to by -changing it in the upper-left-hand corner of the screen. +To populate the Apps UI, the web app queries the Polkadot-JS API. The API then queries a node and +uses JavaScript to return information that the UI will display on the screen. You can choose which +node to connect to by changing it in the upper-left-hand corner of the screen. Let's see how we can query on-chain data with Polkadot-JS UI on the Polkadot network with an example. To find out the current value for existential deposit, navigate to Developer > Chain diff --git a/docs/general/staking-apps.md b/docs/general/staking-apps.md index 88cb62dd3ab..7cbac931e64 100644 --- a/docs/general/staking-apps.md +++ b/docs/general/staking-apps.md @@ -23,10 +23,10 @@ and add your protocol native, permissionless, non-custodial NPoS Staking app to ## Polkadot Staking Dashboard The [Polkadot Staking Dashboard](https://staking.polkadot.cloud/#/overview) is a web3 application -dedicated to native non-custodial [staking](../learn/learn-staking.md) on the -{{ polkadot: Polkadot :polkadot }}{{ kusama: Kusama :kusama }} relay chain. The dashboard allows to -stake as a solo nominator or as a [nomination pool](../learn/learn-nomination-pools.md) member. -Users can also create their nomination pools. The dashboard supports [Ledger](../general/ledger.md), +dedicated to native non-custodial [staking](../learn/learn-staking.md) on the Relay Chain. The +dashboard allows to stake as a solo nominator or as a +[nomination pool](../learn/learn-nomination-pools.md) member. Users can also create their nomination +pools. The dashboard supports [Ledger](../general/ledger.md), [Polkadot Vault](../general/polkadot-vault.md), [SubWallet](../general/wallets-and-extensions.md#subwallet), [Talisman](../general/wallets-and-extensions.md#talisman), WalletConnect, Fearless Wallet, @@ -89,15 +89,13 @@ Below a list of video tutorial about the Polkadot Staking Dashboard. [Sub.ID](https://sub.id/) is a one-stop-shop for managing your Polkadot accounts, viewing your addresses and balances, and looking at other accounts. It features a Polkadot -[staking page](https://sub.id/validator/polkadot), where you can easily start staking -{{ polkadot: DOT :polkadot }}{{ kusama: KSM :kusama }}. Stakers can choose their preferred -validators or stake with the recommended validator set. +[staking page](https://sub.id/validator/polkadot), where you can easily start staking. Stakers can +choose their preferred validators or stake with the recommended validator set. ## NOMI -[NOMI](https://apps.turboflakes.io/?app=nomi) is designed to actively involve Nominators in Native -Staking within the {{ polkadot: Polkadot :polkadot }}{{ kusama: Kusama :kusama }} networks. It aims -to offer a unique and enhanced nomination experience, using +[NOMI](https://apps.turboflakes.io/?app=nomi) is designed to actively involve nominators in native +staking on the Relay Chain. It aims to offer a unique and enhanced nomination experience, using [Multiple-Criteria Decision Analysis](https://en.wikipedia.org/wiki/Multiple-criteria_decision_analysis) (MCDA) as a base for the analytical research. MCDA is an open and transparent approach for evaluating numerous conflicting traits in the decision-making process. For the analysis, validator diff --git a/docs/general/staking-dashboard.md b/docs/general/staking-dashboard.md index c0a0dc87111..6518a0c4ea9 100644 --- a/docs/general/staking-dashboard.md +++ b/docs/general/staking-dashboard.md @@ -23,17 +23,15 @@ extension or a wallet to use it; you just need your Ledger device. are thus not necessary, as you only need to keep your Ledger apps up-to-date. Before using the dashboard, make sure you have a -[wallet or extension](./wallets-and-extensions.md#browser-extensions) with a funded -{{ polkadot: Polkadot :polkadot }}{{ kusama: Kusama :kusama }} account. Note that accounts on -wallets or extensions can be imported from [Ledger](./ledger.md) or +[wallet or extension](./wallets-and-extensions.md#browser-extensions) with a funded account. Note +that accounts on wallets or extensions can be imported from [Ledger](./ledger.md) or [Polkadot Vault](./polkadot-vault.md). On top of the [existential deposit](../learn/learn-accounts.md#existential-deposit-and-reaping), you need some free balance to pay for [transaction fees](../learn/learn-transactions.md#transaction-fees) and [the minimum amount to place your nominations or join a nomination pool](./chain-state-values.md#minimum-bond-to-participate-in-staking). -For more information about staking on {{ polkadot: Polkadot :polkadot }}{{ kusama: Kusama :kusama }} -visit the [staking page](../learn/learn-staking.md) and the +For more information about staking visit the [staking page](../learn/learn-staking.md) and the [advanced staking page](../learn/learn-staking-advanced.md). ## Using the Polkadot Staking Dashboard @@ -48,7 +46,7 @@ accounts, you can use [wallets and extension](./wallets-and-extensions.md). You staking by being a [nominator](../learn/learn-nominator.md) or a member of a [nomination pool](../learn/learn-nomination-pools.md). Once you have a funded account, you need to connect it to the dashboard (connect button on the top-right corner), this will allow you to -interact with {{ polkadot: Polkadot's :polkadot }}{{ kusama: Kusama's :kusama }} native staking. +interact with native staking. :::info The dashboard is a Web3 dApp @@ -60,7 +58,8 @@ to the world of [true Web3](./web3-and-polkadot.md)! ::: -{{ polkadot: Note the pictures on this page refer to Kusama, but the same applies to Polkadot and Westend. :polkadot }} +Note the pictures on this page refer to Kusama, but the same applies to Polkadot and Westend. + The structure of this page follows the sidebar of the staking dashboard. Here you will learn about the main features of the dashboard. If you need more information, see the [Walkthrough Tutorial](https://youtu.be/hvXLc4H7rA4). @@ -68,14 +67,12 @@ the main features of the dashboard. If you need more information, see the :::info Walk-through Video Tutorials - [**Nominating**](https://youtu.be/F59N3YKYCRs): Stake your tokens, choose your best validators, - and start your staking journey on {{ polkadot: Polkadot :polkadot }}{{ kusama: Kusama :kusama }}. + and start your staking journey. - [**Becoming a Pool Member**](https://youtu.be/dDIG7QAApig): Start becoming a part of the Polkadot - movement, keep {{ polkadot: Polkadot :polkadot }}{{ kusama: Kusama :kusama }} secure by staking - minimum 1 DOT and receiving staking rewards. + movement, keep the network secure by staking minimum 1 DOT and receiving staking rewards. - [**Dashboard Walkthrough**](https://youtu.be/hvXLc4H7rA4): Become a Pro using the Staking Dashboard. -- [**After Staking**](https://youtu.be/58pIe8tt2o4): Nominating on - {{ polkadot: Polkadot :polkadot }}{{ kusama: Kusama :kusama }} is not a set-and-forget action, +- [**After Staking**](https://youtu.be/58pIe8tt2o4): Nominating is not a set-and-forget action, learn what you can do with the dashboard after you started staking. ::: @@ -165,9 +162,9 @@ This page of the dashboard has four main panels (Sidebar and Accounts Panels exc - **Section B: The Balance Panel** shows the number of tokens bonded in pools and those that are free. In this case, we have 0.3 KSM bonded and 0.144 KSM free. In this panel, you can bond more funds (`+` button) or unbond some funds (`-` button). Unbonding will withdraw unclaimed rewards - and funds will be locked for 28 eras - ({{ polkadot: 28 days :polkadot }}{{ kusama: 7 days :kusama }}). Once the 28 eras have passed, you - can unlock the locked funds (button with a lock icon) that will be available as a free balance. + and funds will be locked for the [unbonding period](./chain-state-values.md#unbonding-duration). + Once the unbonding period has passed, you can unlock the locked funds (button with a lock icon) + that will be available as a free balance. :::info No fast unstake and pool swap for pool members @@ -270,9 +267,10 @@ This page of the dashboard has four main panels (Sidebar and Accounts Panels exc - **Section B: The Balance Panel** shows the number of tokens bonded in nominations and those that are free. In this case, we have 0.301 KSM bonded and 0.144 KSM free. In this panel, you can bond more funds (`+` button) or unbond some funds (`-` button). Unbonding will withdraw unclaimed - rewards and funds will be locked for 28 eras - ({{ polkadot: 28 days :polkadot }}{{ kusama: 7 days :kusama }}). Once the 28 eras have passed, you - can unlock the locked funds (button with a lock icon) that will be available as a free balance. + rewards and funds will be locked for the + [unbonding period](./chain-state-values.md#unbonding-duration). Once the unbonding period has + passed, you can unlock the locked funds (button with a lock icon) that will be available as a free + balance. :::info Fast unstake diff --git a/docs/general/thousand-validators.md b/docs/general/thousand-validators.md index bfa9f25f6ca..3f138a17154 100644 --- a/docs/general/thousand-validators.md +++ b/docs/general/thousand-validators.md @@ -7,6 +7,8 @@ keywords: [thousand validators program, validator, validate, maintain, TVP] slug: ../thousand-validators --- +import Tabs from "@theme/Tabs"; import TabItem from "@theme/TabItem"; + The Thousand Validators Programme is an initiative by Web3 Foundation and Parity Technologies to use the funds held by both organizations to nominate validators in the community. @@ -18,9 +20,8 @@ It serves two major purposes: ## How it Works The [nominating backend](https://github.com/w3f/1k-validators-be) will routinely change its -nominations at every {{ polkadot: era :polkadot }}{{ kusama: four eras :kusama }}. The backend does -this by short-listing candidates by validity and then sorts validators by their weighted score in -descending order. +nominations at every era (four eras on Kusama). The backend does this by short-listing candidates by +validity and then sorts validators by their weighted score in descending order. - Validators with a higher weighted score are selected for any possible slots. As validators are nominated and actively validate, their weighted scores decrease allowing other validators to be @@ -42,11 +43,12 @@ information on how to [secure a validator](../maintain/maintain-guides-secure-va ## How to Apply -{{ polkadot: **Entrance to the Polkadot program requires a rank of 100 or higher in the Kusama program.** +**Entrance to the Polkadot program requires a rank of 100 or higher in the Kusama program.** Attaining a rank of 100 usually takes around two months. The leaderboard is available -[here](https://thousand-validators.kusama.network/#/leaderboard). -In order to apply to the Polkadot 1KV programme, set up your Polkadot node to adhere to the [requirements](#requirements) below -and fill in the [application form](https://forms.gle/LTCze7fJvqQinPqx6). You will hear back from the team shortly. :polkadot }} +[here](https://thousand-validators.kusama.network/#/leaderboard). In order to apply to the Polkadot +1KV programme, set up your Polkadot node to adhere to the [requirements](#requirements) below and +fill in the [application form](https://forms.gle/LTCze7fJvqQinPqx6). You will hear back from the +team shortly. {{ kusama: In order to apply to the Kusama 1KV programme, set up your node to adhere to the requirements below and fill in the [application form](https://forms.gle/dZkWrGWCNG3ENVCfA). The process of review and addition is a manual one; you'll be invited to the 1KV Kusama channel and added to the leaderboard, if accepted. :kusama }} @@ -56,35 +58,53 @@ and fill in the [application form](https://forms.gle/dZkWrGWCNG3ENVCfA). The pro - Verified identity (see [here](../learn/learn-identity.md#setting-an-identity) for instructions) - Connect to dedicated telemetry (use `--telemetry-url 'wss://telemetry-backend.w3f.community/submit 1'` when starting the node) -- {{ polkadot: Minimum of 5_000 DOTs self stake :polkadot }}{{ kusama: Minimum of 10 KSM self-stake :kusama }} -- {{ polkadot: No more than 5% commission :polkadot }}{{ kusama: No more than 15% commission :kusama }} +- Minimum of 5_000 DOTs self stake on Polkadot and 10 KSM on Kusama +- No more than 5% commission on Polkadot and 15% commission on Kusama - Have a staking proxy set up - Must be on the latest release -- {{ polkadot: Maximum one node per applicant :polkadot }}{{ kusama: Max two nodes (under same sub/super identity) :kusama }} +- Maximum one node per applicant on Polkadot and two nodes (under same sub/super identity) on Kusama - Validators must operate nodes themselves. They may not be operated by third parties or staking providers. #### Nominators The below addresses are the stash / staking proxy pairs for the primary nominators involved in the -{{ polkadot: Polkadot :polkadot }}{{ kusama: Kusama :kusama }} Thousand Validators programme. They -are formatted like "`stash` / `staking proxy`". - -{{ polkadot: - `14Ns6kKbCoka3MS4Hn6b7oRw9fFejG8RH5rq5j63cWUfpPDJ` / `12iz6aJ75KdqVZLGyvFJmgc5k74Pdokgy9UGTgWtnt67RNTg` :polkadot }} -{{ kusama: - `G1rrUNQSk7CjjEmLSGcpNu72tVtyzbWdUvgmSer9eBitXWf` / `Edyfdyoi4KJVdXUJ3SU3nuZYMpg13HHa1SWYtPDCV8UPdxy` :kusama }} - -{{ polkadot: - `12RYJb5gG4hfoWPK3owEYtmWoko8G6zwYpvDYTyXFVSfJr8Y` / `12iz6aJ75KdqVZLGyvFJmgc5k74Pdokgy9UGTgWtnt67RNTg` :polkadot }} -{{ kusama: - `HgTtJusFEn2gmMmB5wmJDnMRXKD6dzqCpNR7a99kkQ7BNvX` / `Edyfdyoi4KJVdXUJ3SU3nuZYMpg13HHa1SWYtPDCV8UPdxy` :kusama }} - -{{ polkadot: - `16GMHo9HZv8CcJy4WLoMaU9qusgzx2wxKDLbXStEBvt5274B` / `12iz6aJ75KdqVZLGyvFJmgc5k74Pdokgy9UGTgWtnt67RNTg` :polkadot }} -{{ kusama: - `EX9uchmfeSqKTM7cMMg8DkH49XV8i4R7a7rqCn8btpZBHDP` / `Edyfdyoi4KJVdXUJ3SU3nuZYMpg13HHa1SWYtPDCV8UPdxy` :kusama }} - -{{ polkadot: - `13yk62yQYctYsRPXDFvC5WzBtanAsHDasenooLAxKvf5bNkK` / `12iz6aJ75KdqVZLGyvFJmgc5k74Pdokgy9UGTgWtnt67RNTg` :polkadot }} -{{ kusama: - `JLENz97TFT2kYaQmyCSEnBsK8VhaDZNmYATfsLCHyLF6Gzu` / `Edyfdyoi4KJVdXUJ3SU3nuZYMpg13HHa1SWYtPDCV8UPdxy` :kusama }} - -{{ polkadot: - `13SkL2uACPqBzpKBh3d2n5msYNFB2QapA5vEDeKeLjG2LS3Y` / `12iz6aJ75KdqVZLGyvFJmgc5k74Pdokgy9UGTgWtnt67RNTg` :polkadot }} - -{{ polkadot: - `12WLDL2AXoH3MHr1xj8K4m9rCcRKSWKTUz8A4mX3ah5khJBn` / `12iz6aJ75KdqVZLGyvFJmgc5k74Pdokgy9UGTgWtnt67RNTg` :polkadot }} +Thousand Validators programme. They are formatted like "`stash` / `staking proxy`". + + + + + + + +- `14Ns6kKbCoka3MS4Hn6b7oRw9fFejG8RH5rq5j63cWUfpPDJ` / + `12iz6aJ75KdqVZLGyvFJmgc5k74Pdokgy9UGTgWtnt67RNTg` +- `12RYJb5gG4hfoWPK3owEYtmWoko8G6zwYpvDYTyXFVSfJr8Y` / + `12iz6aJ75KdqVZLGyvFJmgc5k74Pdokgy9UGTgWtnt67RNTg` +- `16GMHo9HZv8CcJy4WLoMaU9qusgzx2wxKDLbXStEBvt5274B` / + `12iz6aJ75KdqVZLGyvFJmgc5k74Pdokgy9UGTgWtnt67RNTg` +- `13yk62yQYctYsRPXDFvC5WzBtanAsHDasenooLAxKvf5bNkK` / + `12iz6aJ75KdqVZLGyvFJmgc5k74Pdokgy9UGTgWtnt67RNTg` +- `13SkL2uACPqBzpKBh3d2n5msYNFB2QapA5vEDeKeLjG2LS3Y` / + `12iz6aJ75KdqVZLGyvFJmgc5k74Pdokgy9UGTgWtnt67RNTg` +- `12WLDL2AXoH3MHr1xj8K4m9rCcRKSWKTUz8A4mX3ah5khJBn` / + `12iz6aJ75KdqVZLGyvFJmgc5k74Pdokgy9UGTgWtnt67RNTg` + + + + +- `G1rrUNQSk7CjjEmLSGcpNu72tVtyzbWdUvgmSer9eBitXWf` / + `Edyfdyoi4KJVdXUJ3SU3nuZYMpg13HHa1SWYtPDCV8UPdxy` +- `HgTtJusFEn2gmMmB5wmJDnMRXKD6dzqCpNR7a99kkQ7BNvX` / + `Edyfdyoi4KJVdXUJ3SU3nuZYMpg13HHa1SWYtPDCV8UPdxy` +- `EX9uchmfeSqKTM7cMMg8DkH49XV8i4R7a7rqCn8btpZBHDP` / + `Edyfdyoi4KJVdXUJ3SU3nuZYMpg13HHa1SWYtPDCV8UPdxy` +- `JLENz97TFT2kYaQmyCSEnBsK8VhaDZNmYATfsLCHyLF6Gzu` / + `Edyfdyoi4KJVdXUJ3SU3nuZYMpg13HHa1SWYtPDCV8UPdxy` + + + A time delay proxy is used as the interaction method for some of these accounts. @@ -92,9 +112,8 @@ A time delay proxy is used as the interaction method for some of these accounts. Since approximately early January 2021, the nominators will select an automatic number of validators to nominate based on the lowest amount staked for a validator and the amount of funds it holds. This -can be anywhere from a few validators receiving nomination from a single nominator, to the max of -{{ polkadot: 16 :polkadot }}{{ kusama: 24 :kusama }} nominators on -{{ polkadot: Polkadot :polkadot }}{{ kusama: Kusama :kusama }}. +can be anywhere from a few validators receiving nomination from a single nominator, to the +[max of nominators](./chain-state-values.md#maximum-votes-per-nominator). ## Selection @@ -133,9 +152,9 @@ within the program. #### Unclaimed -The unclaimed weight relates to the number of payouts outstanding for greater than -{{ polkadot: four :polkadot }}{{ kusama: sixteen :kusama }} eras. Each payout that exceeds this -threshold would attribute a negative score of 10 points. +The unclaimed weight relates to the number of payouts outstanding for greater than four eras on +Polkadot and sixteen on Kusama. Each payout that exceeds this threshold would attribute a negative +score of 10 points. #### Bonded \* @@ -169,8 +188,7 @@ allocate > 75% of their bond to the respective council members. #### Democracy Candidates will receive 10 \* 1KV points for each referendum they have voted on (Aye/Nay) to a limit -of 100 points. Scores are based on votes for referendum -{{ polkadot: 49 :polkadot }}{{ kusama: 163 :kusama }} and beyond. +of 100 points. Scores are based on votes for referendum 49 on Polkadot (163 on Kusama) and beyond. \* Scores that are based on their relative position against others are assessed as follows: diff --git a/docs/general/transaction-attacks.md b/docs/general/transaction-attacks.md index 9dfd4a11f9a..fb08a5b6388 100644 --- a/docs/general/transaction-attacks.md +++ b/docs/general/transaction-attacks.md @@ -77,8 +77,7 @@ relatively short mortality window will almost certainly ensure that replay attac with the only exception being if the account is reaped and then re-funded shortly after submitting a mortal transaction, and then an attacker replays that transaction within the mortality window (i.e., the specified block interval) and such transaction is valid (e.g. if you only have 10 DOT, and you -try to issue an extrinsic sending 20 {{ polkadot: DOT :polkadot }}{{ kusama: KSM :kusama }}, the -transfer will fail). +try to issue an extrinsic sending 20 DOT, the transfer will fail). ## Defense against Attacks diff --git a/docs/general/wallets-and-extensions.md b/docs/general/wallets-and-extensions.md index fa23980b76d..db26c6b1ac1 100644 --- a/docs/general/wallets-and-extensions.md +++ b/docs/general/wallets-and-extensions.md @@ -38,10 +38,9 @@ can access your account's private key. ::: -To realize the multichain vision of {{ polkadot: Polkadot :polkadot }}{{ kusama: Kusama :kusama }}, -it is important to have non-custodial wallets that make it convenient to interact with multiple -blockchains in {{ polkadot: Polkadot :polkadot }}{{ kusama: Kusama :kusama }} ecosystem. Below there -is a list of all non-custodial treasury-funded wallets developed by the community. +To realize Polkadot's multichain vision, it is important to have non-custodial wallets that make it +convenient to interact with multiple blockchains within the Polkadot ecosystem. Below there is a +list of all non-custodial treasury-funded wallets developed by the community. ## Overview diff --git a/docs/general/web3-and-polkadot.md b/docs/general/web3-and-polkadot.md index 006d84a34d4..8200d0855ad 100644 --- a/docs/general/web3-and-polkadot.md +++ b/docs/general/web3-and-polkadot.md @@ -81,9 +81,8 @@ together with the hash of the previous block `N`. This creates the situation whe content of block `N` you will change the hash of block `N + 1`, `N + 2`, etc. essentially breaking the chain. Although it can be possible to add an invalid block (a block with invalid transactions) or censor certain transactions, if the blockchain network is not sufficiently decentralized. In -decentralized proof-of-stake blockchains like -{{ polkadot: Polkadot :polkadot }}{{ kusama: Kusama :kusama }} such attacks are financially -expensive, and attempting to do it can get you [slashed](../learn/learn-offenses.md). +decentralized proof-of-stake blockchains like Polkadot such attacks are financially expensive, and +attempting to do it can get you [slashed](../learn/learn-offenses.md). So, with blockchain as a means of storing data and transactions permanently without an option to modify them, we can ensure what we cryptographically sign with our digital identity is set in stone @@ -136,9 +135,8 @@ Nowadays, most of the nodes cannot be run on consumer-grade hardware. Node runni typically rented through service providers. Resiliency is also achieved by ensuring nodes run on as many different providers as possible and avoiding a significant share of the nodes being run under the same provider in the same geographic region. A legislation change or a natural disaster could -impact a considerable fraction of the nodes and potentially stop the network. -{{ polkadot: Polkadot :polkadot }}{{ kusama: Kusama :kusama }} level of decentralization can be -explored through the [Polkawatch app](https://polkawatch.app/). +impact a considerable fraction of the nodes and potentially stop the network. Polkadot's level of +decentralization can be explored through the [Polkawatch app](https://polkawatch.app/). The [One Thousand Validator Programme](./thousand-validators.md) aims to incentivize the creation of new validator nodes to increase the level of node decentralization. @@ -158,8 +156,7 @@ protocols like [IPFS](https://ipfs.tech/). In Proof-of-Stake blockchains, security is dictated by how much stake is locked on-chain (financial security). In a decentralized network, you want to ensure that the difficulty level for a financial -attack to happen is equally difficult across all nodes. -{{ polkadot: Polkadot :polkadot }}{{ kusama: Kusama :kusama }}'s +attack to happen is equally difficult across all nodes. Polkadot's [election algorithm](../learn/learn-phragmen.md) makes sure that the stake is maximized across all active validators, and the variance in stake across validators is minimized as much as possible. @@ -178,8 +175,7 @@ the staking rate, part of the inflation is diverted to the treasury. ### Governance and Treasury -In {{ polkadot: Polkadot :polkadot }}{{ kusama: Kusama :kusama }} an on-chain -[treasury](../learn/learn-polkadot-opengov-treasury.md) together with an +In Polkadot, an on-chain [treasury](../learn/learn-polkadot-opengov-treasury.md) together with an [open governance](../learn/learn-polkadot-opengov.md) model allow to access funds in a fully decentralized manner without any bank transaction whatsoever. This opens up the possibility to come to a decision through on-chain voting mechanism, promoting a sense of community and creating an