Skip to content

Commit

Permalink
Wiki reorg: Remove RPC calls from Build and Maintain (#6201)
Browse files Browse the repository at this point in the history
* rm RPC calls

* Update docs/maintain/maintain-guides-how-to-chill.md

Co-authored-by: bader y <[email protected]>

* Update docs/general/chain-state-values.md

Co-authored-by: Radha <[email protected]>

* Radha's and Bader's feedback

* minor edit

---------

Co-authored-by: bader y <[email protected]>
Co-authored-by: Radha <[email protected]>
  • Loading branch information
3 people authored Sep 4, 2024
1 parent 8baad5f commit 14dd966
Show file tree
Hide file tree
Showing 6 changed files with 38 additions and 49 deletions.
9 changes: 4 additions & 5 deletions docs/build/build-protocol-info.md
Original file line number Diff line number Diff line change
Expand Up @@ -154,11 +154,10 @@ valid. If the extrinsic is not included in a block within this validity window,
from the transaction queue.

The chain only stores a limited number of prior block hashes as reference. You can query this
parameter, called `BlockHashCount`, from the chain state or metadata. This parameter is set to
{{ polkadot: <RPC network="polkadot" path="consts.system.blockHashCount" defaultValue={4096}/> :polkadot }}
blocks (about seven hours) at genesis. If the validity period is larger than the number of blocks
stored on-chain, then the transaction will only be valid as long as there is a block to check it
against, i.e. the minimum value of validity period and block hash count.
parameter, called [`BlockHashCount`](../general/chain-state-values.md#block-hash-count), from the
chain state or metadata. If the validity period is larger than the number of blocks stored on-chain,
then the transaction will only be valid as long as there is a block to check it against, i.e. the
minimum value of validity period and block hash count.

Setting the block checkpoint to zero, using the genesis hash, and a validity period of zero will
make the transaction "immortal".
Expand Down
26 changes: 26 additions & 0 deletions docs/general/chain-state-values.md
Original file line number Diff line number Diff line change
Expand Up @@ -63,6 +63,10 @@ The number of Polkadot validators in the active set is <RPC network="polkadot" p

The auction ending period on Polkadot is <RPC network="polkadot" path="consts.auctions.endingPeriod" defaultValue={72000} filter="blocksToDays"/> days long.

#### Block Hash Count

On Polkadot, the maximum number of block hashes retained on-chain at any given time is <RPC network="polkadot" path="consts.system.blockHashCount" defaultValue={4096}/> (which maps to seven hours given 6-second block times).

#### Bounty Curator Deposit

On Polkadot, the bounty curator deposit is calculated by multiplying the curator fee by the bounty curator deposit multiplier set to <RPC network="polkadot" path="consts.bounties.curatorDepositMultiplier" defaultValue={500000} filter="permillToPercent"/>%. The deposit can range between a minimum of <RPC network="polkadot" path="consts.bounties.curatorDepositMin" defaultValue={100000000000} filter="humanReadable"/> and a maximum of <RPC network="polkadot" path="consts.bounties.curatorDepositMax" defaultValue={2000000000000} filter="humanReadable"/>.
Expand Down Expand Up @@ -127,6 +131,15 @@ The minimum bond to nominate on Polkadot is <RPC network="polkadot" path="query.

The minimum amount to participate to a Polkadot crowdloan is <RPC network="polkadot" path="consts.crowdloan.minContribution" defaultValue={50000000000} filter="humanReadable"/>.

#### Minimum Validator Bond

To start a validator instance on Polkadot, the
minimum bond required is <RPC network="polkadot" path="query.staking.minValidatorBond" defaultValue="0" filter= "humanReadable"/>.

#### Minimum Validator Commission

The minimum commission a Polkadot Validator can set is <RPC network="polkadot" path="query.staking.minCommission" filter = "percentage" defaultValue="0"/>%. [This does not guarantee entry into the active set and earning rewards](../maintain/maintain-guides-how-to-validate-polkadot.md#how-many-dot-do-i-need-to-become-an-active-validator).

#### Multisig Deposit Base

The multisig deposit base on Polkadot is <RPC network="polkadot" path="consts.multisig.depositBase" defaultValue={200880000000} filter="humanReadable"/>.
Expand Down Expand Up @@ -234,6 +247,10 @@ The number of Kusama validators in the active set is <RPC network="kusama" path=

The auction ending period on Kusama is <RPC network="kusama" path="consts.auctions.endingPeriod" defaultValue={72000} filter="blocksToDays"/> days long.

#### Block Hash Count

On Kusama, the maximum block number to block hash mappings to keep is <RPC network="kusama" path="consts.system.blockHashCount" defaultValue={4096}/> (which maps to seven hours given 6-second block times).

#### Bounty Curator Deposit

On Kusama, the bounty curator deposit is calculated by multiplying the curator fee by the bounty curator deposit multiplier set to <RPC network="kusama" path="consts.bounties.curatorDepositMultiplier" defaultValue={500000} filter="permillToPercent"/>%. The deposit can range between a minimum of <RPC network="kusama" path="consts.bounties.curatorDepositMin" defaultValue={3333333330} filter="humanReadable"/> and a maximum of <RPC network="kusama" path="consts.bounties.curatorDepositMax" defaultValue={166666666500} filter="humanReadable"/>.
Expand Down Expand Up @@ -298,6 +315,15 @@ The minimum bond to nominate on Kusama is <RPC network="kusama" path="query.stak

The minimum amount to participate to a Kusama crowdloan is <RPC network="kusama" path="consts.crowdloan.minContribution" defaultValue={100000000000} filter="humanReadable"/>.

#### Minimum Validator Bond

To start a validator instance on Kusama, the
minimum bond required is <RPC network="kusama" path="query.staking.minValidatorBond" defaultValue="0" filter= "humanReadable"/>.

#### Minimum Validator Commission

The minimum commission a Kusama Validator can set is <RPC network="kusama" path="query.staking.minCommission" filter = "percentage" defaultValue="10"/>%.

#### Multisig Deposit Base

The multisig deposit base on Kusama is <RPC network="kusama" path="consts.multisig.depositBase" defaultValue={669599996400} filter="humanReadable"/>.
Expand Down
24 changes: 3 additions & 21 deletions docs/maintain/kusama/maintain-guides-how-to-validate-kusama.md
Original file line number Diff line number Diff line change
Expand Up @@ -57,23 +57,6 @@ with the existential deposit, plus a little extra for transaction fees. The rest
nominators. To understand how validators are elected, check the
[NPoS Election algorithms](../../learn/learn-phragmen.md) page.

:::info On-Chain Data for Reference

On Kusama, the minimum stake backing a validator in the active set is
{{ kusama: <MinimumStake network="kusama" defaultValue={5288388652143741} /> :kusama }}
{{ polkadot: <MinimumStake network="kusama" defaultValue={5288388652143741} /> :polkadot }} in the
era
{{ kusama: <RPC network="kusama" path="query.staking.currentEra" defaultValue="4838"/>. :kusama }}
{{ polkadot: <RPC network="kusama" path="query.staking.currentEra" defaultValue="4838"/>. :polkadot }}

On Polkadot, the minimum stake backing a validator in the active set is
{{ polkadot: <MinimumStake network="polkadot" defaultValue={17314855524834056}/> :polkadot }}
{{ kusama: <MinimumStake network="polkadot" defaultValue={17314855524834056}/> :kusama }} in the era
{{ polkadot: <RPC network="polkadot" path="query.staking.currentEra" defaultValue="998"/>. :polkadot }}
{{ kusama: <RPC network="polkadot" path="query.staking.currentEra" defaultValue="998"/>. :kusama }}

:::

:::tip Join the Thousand Validator Programme

[The Thousand Validator Programme](../../general/thousand-validators.md) is an initiative by Web3
Expand All @@ -92,10 +75,9 @@ instead.
On Kusama, one day is approximately four eras whereas on Polkadot, one era is approximately a day.
In each era, the validators elected to the active set earn era points which correspond to the actual
rewards earned that are distributed proportionally to the nominators after deducting the validator
commission. Currently, the minimum validator commission is set to
{{ kusama: <RPC network="kusama" path="query.staking.minCommission" filter = "percentage" defaultValue="10"/>% :kusama }}
{{ polkadot: <RPC network="kusama" path="query.staking.minCommission" filter = "percentage" defaultValue="10"/>% :polkadot }}
which can be set through on-chain governance. For more information rewards and payouts, check the
commission. The
[minimum validator commission](../../general/chain-state-values.md#minimum-validator-commission) can
be set through on-chain governance. For more information rewards and payouts, check the
[validator payout](../maintain-guides-validator-payout.md) document.

## Run a Kusama Validator
Expand Down
4 changes: 1 addition & 3 deletions docs/maintain/maintain-guides-how-to-chill.md
Original file line number Diff line number Diff line change
Expand Up @@ -75,9 +75,7 @@ requirements.
:::note Chill Threshold

`ChillThreshold` defines how close to the max nominators or validators we must reach before users
can start chilling one-another. This value is currently set to
{{ polkadot: <RPC network="polkadot" path="query.staking.chillThreshold" defaultValue={90}/>% :polkadot }}
{{ kusama: <RPC network="kusama" path="query.staking.chillThreshold" defaultValue={90}/>% :kusama }}
can start chilling one another.

:::

Expand Down
9 changes: 3 additions & 6 deletions docs/maintain/maintain-guides-how-to-validate-polkadot.md
Original file line number Diff line number Diff line change
Expand Up @@ -533,12 +533,9 @@ a non-canonical chain.

## Bond DOT

To start a validator instance on {{ polkadot: Polkadot :polkadot }}{{ kusama: Kusama :kusama }}, the
minimum bond required is
{{ polkadot: <RPC network="polkadot" path="query.staking.minValidatorBond" defaultValue="0" filter= "humanReadable"/>. :polkadot }}
{{ kusama: <RPC network="polkadot" path="query.staking.minValidatorBond" defaultValue="0" filter= "humanReadable"/>. :kusama }}
But to enter the active validator set and be eligible to earn rewards, your validator node should be
nominated by a minimum number of DOT tokens.
There is a [minimum bond](../general/chain-state-values.md#minimum-validator-bond) to start a
validator instance, but to enter the active validator set and be eligible to earn rewards, your
validator node should be nominated by a minimum number of DOT tokens.

For example, the minimum stake backing a validator in era
{{ polkadot: 1449 :polkadot }}{{ kusama: 6646 :kusama }} (May 21st 2024) is
Expand Down
15 changes: 1 addition & 14 deletions docs/maintain/maintain-polkadot-parameters.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,8 +7,7 @@ keywords: [parameters, actions, attributes, behaviors]
slug: ../maintain-polkadot-parameters
---

import RPC from "./../../components/RPC-Connection"; import Tabs from "@theme/Tabs"; import TabItem
from "@theme/TabItem";
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
Expand Down Expand Up @@ -59,18 +58,6 @@ itself._
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: <RPC network="polkadot" path="consts.balances.existentialDeposit" defaultValue={10000000000} filter="humanReadable"/> :polkadot }}
{{ kusama: <RPC network="kusama" path="consts.balances.existentialDeposit" defaultValue={10000000000} filter="humanReadable"/> :kusama }}
- The deposit required to set an Identity is
{{ polkadot: <RPC network="polkadotpeople" path="consts.identity.basicDeposit" defaultValue={2001700000} filter="humanReadable"/> :polkadot }}
{{ kusama: <RPC network="kusamapeople" path="consts.identity.basicDeposit" defaultValue={6672333321} filter="humanReadable"/> :kusama }}
- The minimum contribution required to participate in a crowdloan is
{{ polkadot: <RPC network="polkadot" path="consts.crowdloan.minContribution" defaultValue={50000000000} filter="humanReadable"/> :polkadot }}
{{ kusama: <RPC network="kusama" path="consts.crowdloan.minContribution" defaultValue={50000000000} filter="humanReadable"/> :kusama }}

### Governance

<!-- prettier-ignore -->
Expand Down

0 comments on commit 14dd966

Please sign in to comment.