diff --git a/docs/general/kusama/kusama-parameters.md b/docs/general/kusama/kusama-parameters.md deleted file mode 100644 index 50452f8a5001..000000000000 --- a/docs/general/kusama/kusama-parameters.md +++ /dev/null @@ -1,95 +0,0 @@ ---- -id: kusama-parameters -title: Kusama Parameters -sidebar_label: Parameters -description: Learn about common Kusama parameters -keywords: [parameters, kusama, on-chain] -slug: ../../kusama-parameters ---- - -import RPC from "./../../../components/RPC-Connection"; - -Many of these parameter values can be updated via on-chain governance. If you require absolute -certainty of these parameter values, it is recommended you directly check the constants by looking -at the [chain state](https://polkadot.js.org/apps/#/chainstate/constants) and/or -[storage](https://polkadot.js.org/apps/#/chainstate). - -### Periods of common actions and attributes - -_NOTE: Kusama generally runs 4x as fast as Polkadot, except in the time slot duration itself. See -[Polkadot Parameters](../../maintain/maintain-polkadot-parameters.md) for more details on how -Kusama's parameters differ from Polkadot's._ - -- Slot: 6 seconds \*(generally one block per slot, although see note below) -- Epoch: 1 hour (600 slots x 6 seconds) -- Session: 1 hour (6 sessions per Era) -- Era: 6 hours (3600 slots x 6 seconds) - -| Kusama | Time | Slots\* | -| ------- | --------- | ------- | -| Slot | 6 seconds | 1 | -| Epoch | 1 hour | 600 | -| Session | 1 hour | 600 | -| Era | 6 hours | 3_600 | - -\*_A maximum of one block per slot can be in a canonical chain. Occasionally, a slot will be without -a block in the chain. Thus, the times given are *estimates*. See -[Consensus](../../learn/learn-consensus.md) for more details._ - -### Accounts, Identity and Crowdloans - -- The [Existential Deposit](../../learn/learn-accounts.md#existential-deposit-and-reaping) is - {{ polkadot: :polkadot }} - {{ kusama: :kusama }} -- The deposit required to set an Identity is - {{ polkadot: :polkadot }} - {{ kusama: :kusama }} -- The minimum contribution required to participate in a crowdloan is - {{ polkadot: :polkadot }} - {{ kusama: :kusama }} - -### Governance - -| Democracy | Time | Slots | Description | -| ---------------- | ------ | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| Voting period | 7 days | 100_800 | How long the public can vote on a referendum. | -| Launch period | 7 days | 100_800 | How long the public can select which proposal to hold a referendum on, i.e., every week, the highest-weighted proposal will be selected to have a referendum. | -| Enactment period | 8 days | 115_200 | Time it takes for a successful referendum to be implemented on the network. | - -| Council | Time | Slots | Description | -| ------------- | ----- | ------ | -------------------------------------------------------------------- | -| Term duration | 1 day | 14_400 | The length of a council member's term until the next election round. | -| Voting period | 1 day | 14_400 | The council's voting period for motions. | - -The Kusama Council consists of up to 19 members and up to 19 runners up. - -| Technical committee | Time | Slots | Description | -| ----------------------- | ------- | ------- | ---------------------------------------------------------------------------------------------- | -| Cool-off period | 7 days | 604_800 | The time a veto from the technical committee lasts before the proposal can be submitted again. | -| Emergency voting period | 3 hours | 1_800 | The voting period after the technical committee expedites voting. | - -### Staking, Validating, and Nominating - -A maximum of 24 validators can be nominated by a nominator on Kusama. - -| Kusama | Time | Slots | Description | -| -------------------- | ------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| Term duration | 6 hours | 3_600 | The time for which a validator is in the set after being elected. Note, this duration can be shortened in the case the a validator misbehaves. | -| Nomination period | 6 hours | 3_600 | How often a new validator set is [elected](../../learn/learn-phragmen.md). | -| Bonding duration | 7 days | 604_800 | How long until your funds will be transferrable after unbonding. Note that the bonding duration is defined in eras, not directly by slots. | -| Slash defer duration | 7 days | 604_800 | Prevents overslashing and validators "escaping" and getting their nominators slashed with no repercussions to themselves. Note that the bonding duration is defined in eras, not directly by slots. | - -### Treasury - -| Treasury | Time | Slots | Description | -| ---------------------- | ------ | ------ | ------------------------------------------------------------ | -| Periods between spends | 6 days | 86_400 | When the treasury can spend again after spending previously. | - -Burn percentage is currently `0.20%`, though instead of being burned this amount is temporarily -redirected into the [Society](../../maintain/kusama/maintain-guides-society-kusama.md)'s treasury to -fund growth. - -### Precision - -KSM have 12 decimals of precision. In other words, 1e12 (1_000_000_000_000, or one trillion) Plancks -make up a single KSM. diff --git a/docs/maintain/maintain-polkadot-parameters.md b/docs/maintain/maintain-polkadot-parameters.md index 8e3cda678dc5..153d7d9b1221 100644 --- a/docs/maintain/maintain-polkadot-parameters.md +++ b/docs/maintain/maintain-polkadot-parameters.md @@ -7,7 +7,7 @@ keywords: [parameters, actions, attributes, behaviors] slug: ../maintain-polkadot-parameters --- -import RPC from "./../../components/RPC-Connection"; +import RPC from "./../../components/RPC-Connection"; import Tabs from "@theme/Tabs"; import TabItem from "@theme/TabItem"; Many of these parameter values can be updated via on-chain governance. If you require absolute certainty of these parameter values, it is recommended you directly check the constants by looking @@ -17,8 +17,12 @@ at the [chain state](https://polkadot.js.org/apps/#/chainstate/constants) and/or ### Periods of common actions and attributes _NOTE: Polkadot generally runs at ¼th the speed of Kusama, except in the time slot duration -itself. See [Kusama Parameters](https://guide.kusama.network/docs/kusama-parameters/) for more -details on how Polkadot's parameters differ from Kusama's._ +itself._ + + + + + - Slot: 6 seconds \*(generally one block per slot, although see note below) - Epoch: 4 hours (2_400 slots x 6 seconds) @@ -32,6 +36,24 @@ details on how Polkadot's parameters differ from Kusama's._ | Session | 4 hours | 2_400 | | Era | 24 hours | 14_400 | + + + +- Slot: 6 seconds \*(generally one block per slot, although see note below) +- Epoch: 1 hour (600 slots x 6 seconds) +- Session: 1 hour (6 sessions per Era) +- Era: 6 hours (3600 slots x 6 seconds) + +| Kusama | Time | Slots\* | +| ------- | --------- | ------- | +| Slot | 6 seconds | 1 | +| Epoch | 1 hour | 600 | +| Session | 1 hour | 600 | +| Era | 6 hours | 3_600 | + + + + \*_A maximum of one block per slot can be in a canonical chain. Occasionally, a slot will be without a block in the chain. Thus, the times given are *estimates*. See [Consensus](../learn/learn-consensus.md) for more details._ @@ -50,36 +72,67 @@ a block in the chain. Thus, the times given are *estimates*. See ### Governance -| Democracy | Time | Slots | Description | -| ---------------- | ------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| Voting period | 28 days | 403_200 | How long the public can vote on a referendum. | -| Launch period | 28 days | 403_200 | How long the public can select which proposal to hold a referendum on, i.e., every week, the highest-weighted proposal will be selected to have a referendum. | -| Enactment period | 28 days | 403_200 | Time it takes for a successful referendum to be implemented on the network. | + + + + + + | Parameter | Time | Slots | Description | + | ---------------- | ------- | ------- | ----------------------------------------------------------------------------------------------------- | + | Voting period | 28 days | 403_200 | How long the public can vote on a referendum. | + | Enactment period | 28 days | 403_200 | Time it takes for a successful referendum to be implemented on the network. | -| Council | Time | Slots | Description | -| ------------- | ------ | ------- | -------------------------------------------------------------------- | -| Term duration | 7 days | 100_800 | The length of a council member's term until the next election round. | -| Voting period | 7 days | 100_800 | The council's voting period for motions. | + -The Polkadot Council consists of up to 13 members and up to 20 runners up. + -| Technical committee | Time | Slots | Description | -| ----------------------- | ------- | ------- | ---------------------------------------------------------------------------------------------- | -| Cool-off period | 7 days | 100_800 | The time a veto from the technical committee lasts before the proposal can be submitted again. | -| Emergency voting period | 3 hours | 1_800 | The voting period after the technical committee expedites voting. | + | Parameter | Time | Slots | Description | + | ---------------- | ------ | ------- | ----------------------------------------------------------------------------------------------------- | + | Voting period | 7 days | 100_800 | How long the public can vote on a referendum. | + | Enactment period | 8 days | 115_200 | Time it takes for a successful referendum to be implemented on the network. | + + + + ### Staking, Validating, and Nominating The maximum number of validators that can be nominated by a nominator is {{ polkadot: 16. :polkadot }} {{ kusama: 24. :kusama }} -| Polkadot | Time | Slots | Description | + + + + + +| Parameter | Time | Slots | Description | | -------------------- | ------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Term duration | 1 Day | 14_400 | The time for which a validator is in the set after being elected. Note, this duration can be shortened in the case that a validator misbehaves. | -| Nomination period | 1 Day | 14_400 | How often a new validator set is elected according to Phragmén's method. | +| Nomination period | 1 Day | 14_400 | How often a new validator set is elected according to [Phragmén's method](../learn/learn-phragmen.md). | | Bonding duration | 28 days | 403_200 | How long until your funds will be transferrable after unbonding. Note that the bonding duration is defined in eras, not directly by slots. | | Slash defer duration | 28 days | 403_200 | Prevents overslashing and validators "escaping" and getting their nominators slashed with no repercussions to themselves. Note that the bonding duration is defined in eras, not directly by slots. | + + + + + | Parameter | Time | Slots | Description | +| -------------------- | ------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Term duration | 6 hours | 3_600 | The time for which a validator is in the set after being elected. Note, this duration can be shortened in the case that a validator misbehaves. | +| Nomination period | 6 hours | 3_600 | How often a new validator set is elected according to [Phragmén's method](../learn/learn-phragmen.md). | +| Bonding duration | 7 days | 604_800 | How long until your funds will be transferrable after unbonding. Note that the bonding duration is defined in eras, not directly by slots. | +| Slash defer duration | 7 days | 604_800 | Prevents overslashing and validators "escaping" and getting their nominators slashed with no repercussions to themselves. Note that the bonding duration is defined in eras, not directly by slots. | + + + + + ### Parachains | Crowdloans and Auctions | Time | Slots | Description | @@ -95,17 +148,60 @@ The maximum number of validators that can be nominated by a nominator is ### Treasury + + + + + | Treasury | Time | Slots | Description | | ---------------------- | ------- | ------- | ------------------------------------------------------------ | | Periods between spends | 24 days | 345_600 | When the treasury can spend again after spending previously. | Burn percentage is currently `1.00%`. + + + + + | Treasury | Time | Slots | Description | +| ---------------------- | ------ | ------ | ------------------------------------------------------------ | +| Periods between spends | 6 days | 86_400 | When the treasury can spend again after spending previously. | + +Burn percentage is currently `0.20%`, though instead of being burned this amount is temporarily +redirected into the [Society](../maintain/kusama/maintain-guides-society-kusama.md)'s treasury to +fund growth. + + + + + ### Precision + + + + + DOT have 10 decimals of precision. In other words, 10 \*\* 10 (10_000_000_000 or ten billion) Plancks make up a DOT. The denomination of DOT was changed from 12 decimals of precision at block #1,248,328 in an event known as _Denomination Day_. See [Redenomination](../learn/archive/learn-redenomination.md) for details. + + + + + +KSM have 12 decimals of precision. In other words, 1e12 (1_000_000_000_000, or one trillion) Plancks +make up a single KSM. + + + + \ No newline at end of file diff --git a/kusama-guide/docusaurus.config.js b/kusama-guide/docusaurus.config.js index 5ee8f86aff56..f81d704b8e58 100644 --- a/kusama-guide/docusaurus.config.js +++ b/kusama-guide/docusaurus.config.js @@ -113,6 +113,10 @@ module.exports = { to: '/docs/learn-guides-claims', from: ['/docs/kusama-claims'] }, + { + to: '/docs/maintain-polkadot-parameters', + from: ['/docs/kusama-parameters'] + }, { to: '/docs/kusama-getting-started', from: ['/docs/kusama-index'] diff --git a/kusama-guide/sidebars.js b/kusama-guide/sidebars.js index bdbd1528a8aa..8e0644cc573e 100644 --- a/kusama-guide/sidebars.js +++ b/kusama-guide/sidebars.js @@ -17,7 +17,7 @@ module.exports = { items: [ "general/kusama/kusama-getting-started", "general/kusama/kusama-coc", - "general/kusama/kusama-parameters", + "maintain/maintain-polkadot-parameters", "general/kusama/kusama-timeline", "general/kusama/kusama-community", "maintain/kusama/maintain-guides-society-kusama",