From aba6f187d7e84c487c6115106981251722a0816d Mon Sep 17 00:00:00 2001 From: Filippo <110459737+filippoweb3@users.noreply.github.com> Date: Thu, 9 Nov 2023 09:52:24 +0100 Subject: [PATCH] Edit Polkadot JS sections Pt. 1 (#5340) * removed duplicated delegation dashboard section * major edits - Polkadot-JS guides - descriptions, etc * moved vault guides * moved JS guides * modified keywords * rm js stuff from gov apps page * rm js from crowdloan page * minor removals * created js guides page for ledger * moved ledger derivation to advanced - deleted js mention (not necessary) * rm js mentions * rm js content from vault page * rm js from staking dashboard * added links * Update docs/general/how-to-dyor.md Co-authored-by: Bill Laboon --------- Co-authored-by: Bill Laboon --- docs/general/governance-apps.md | 8 ++ docs/general/how-to-dyor.md | 23 ++- docs/general/ledger.md | 149 ++------------------ docs/general/metadata.md | 2 +- docs/general/multisig-apps.md | 2 +- docs/general/polkadot-vault.md | 13 +- docs/general/polkadotjs.md | 2 +- docs/general/staking-apps.md | 7 +- docs/general/staking-dashboard.md | 13 +- docs/learn/learn-account-advanced.md | 74 +++++----- docs/learn/learn-guides-assets-create.md | 8 +- docs/learn/learn-guides-assets-ledger.md | 6 +- docs/learn/learn-guides-bounties.md | 8 +- docs/learn/learn-guides-identity.md | 11 +- docs/learn/learn-guides-ledger.md | 118 ++++++++++++++++ docs/learn/learn-guides-polkadot-opengov.md | 29 +--- docs/learn/learn-guides-staking-pools.md | 24 ++-- docs/learn/learn-guides-staking.md | 12 +- docs/learn/learn-guides-treasury.md | 8 +- docs/learn/learn-guides-vault.md | 53 ++++--- polkadot-wiki/sidebars.js | 97 ++++++------- 21 files changed, 324 insertions(+), 343 deletions(-) create mode 100644 docs/learn/learn-guides-ledger.md diff --git a/docs/general/governance-apps.md b/docs/general/governance-apps.md index 7ae79cbd74c1..0baef980d639 100644 --- a/docs/general/governance-apps.md +++ b/docs/general/governance-apps.md @@ -27,8 +27,16 @@ Anyone interested in being listed as a delegate can add their details on the ::: +To make OpenGov multi-role delegation easy and intuitive, +[Delegation Dashboard](https://delegation.polkadot.network/) provides an interactive interface that +displays the list of delegates and their details. The video tutorial below walks through the +features of the Delegation Dashboard and shows how to perform multi-role delegation. + [![Delegation Dashboard Tutorial](https://img.youtube.com/vi/RapBYZc5ZPo/0.jpg)](https://www.youtube.com/watch?v=RapBYZc5ZPo) +For detailed instructions on how to delegate your voting power using dashboard, check +[this support guide.](https://support.polkadot.network/support/solutions/articles/65000184123-polkadot-opengov-how-to-delegate-your-voting-power). + ## Polkassembly ![Polkassembly](https://github.com/w3f/polkadot-wiki/assets/874046/f2fc1032-ba81-465a-896c-51bd35efd435) diff --git a/docs/general/how-to-dyor.md b/docs/general/how-to-dyor.md index 320d12b95157..db6df4561148 100644 --- a/docs/general/how-to-dyor.md +++ b/docs/general/how-to-dyor.md @@ -317,20 +317,15 @@ likely also surface. So, crowdloans require their own section to ensure particip First of all, only projects that aim to become a parachain should have a crowdloan. If a project is not a parachain candidate, there should not be a crowdloan associated with it. -The optimal way to participate in a parachain crowdloan is natively through the -[Crowdloan module](https://polkadot.js.org/apps/?rpc=wss%3A%2F%2Fkusama-rpc.polkadot.io#/parachains/crowdloan) -on Polkadot-JS Apps. This issues a special extrinsic that locks your funds until the parachain slot -lease period ends and guarantees that your stake will be returned afterwards. You can learn more -about crowdloans through the link above and [here](https://kusama.network/auctions) for Kusama. - -Many parachain candidates offer a way to participate through their site as well. However, you should -ensure that they are using the crowdloan pallet in the background and that they are simply wrapping -that in a nicer, more user-friendly interface. If their crowdloan interface _transfers_ funds to an -account instead, these funds will be totally under their control, and this means you need to fully -trust that the team will use the funds for the crowdloan, will return your share to you when the -lease period ends or if they do not win a slot, and will secure the funds properly. If their -crowdloan involves this kind of mechanism, it should be explicitly mentioned in their site and -documentation. +The optimal way to participate in a parachain crowdloan is through +on-chain, via one of the available [wallets or extensions](./wallets-and-extensions.md). Many parachain candidates offer a way to +participate through their site as well. However, you should ensure that they are using the crowdloan +pallet in the background and that they are simply wrapping that in a nicer, more user-friendly +interface. If their crowdloan interface _transfers_ funds to an account instead, these funds will be +totally under their control, and this means you need to fully trust that the team will use the funds +for the crowdloan, will return your share to you when the lease period ends or if they do not win a +slot, and will secure the funds properly. If their crowdloan involves this kind of mechanism, it +should be explicitly mentioned in their site and documentation. That being said, some teams have been doing token sales or swaps in an attempt to get a head start in raising funds for the auctions, but these are **not crowdloans** and still require full trust in diff --git a/docs/general/ledger.md b/docs/general/ledger.md index c6081428b626..f003e1defc79 100644 --- a/docs/general/ledger.md +++ b/docs/general/ledger.md @@ -66,10 +66,10 @@ functionalities. If you do use a Nano S with the XL version you will not be able to: - Install any other Ledger application on your device -- Add Polkadot accounts to the Ledger Live App, but you will be able to add them to - [**treasury-funded wallets**](./wallets-and-extensions.md) who support ledger devices or to the - [**browser extension**](./polkadotjs.md#polkadot-js-extension) and the - [**Polkadot-JS UI**](./polkadotjs-ui.md). +- Add Polkadot accounts to the Ledger Live App. + +But you will be able to add them to [**wallets and extensions**](./wallets-and-extensions.md) that +support Ledger devices. ::: @@ -82,142 +82,15 @@ Here is a list of what you will need before using - 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). -- Ledger Live is installed and at version 2.1 or newer (see settings -> about to find out if you're - up to date). -- A Chromium-based web browser is installed that you can use to access the - [Polkadot-JS UI](https://www.ledger.com/). +- Ledger Live is installed and up-to-date. +- A Chromium-based web browser if you use a browser extension. ## Using Ledger Live -Check +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. -:::info - -Ledger Live will only show the main account with BIP44 path 44'/354'/0'/0'/0'. This means that if -you import a [derived account using Polkadot-JS](#using-on-polkadot-js-apps) with a derivation path -44'/354'/0'/0'/1', it will not be displayed on the Ledger Live App. Consequently, it is not possible -to transact with derived accounts using the Ledger Live App, but it is possible to do so using -Polkadot-JS. Check [the accounts page](../learn/learn-accounts.md) for more information about -derived accounts and derivation paths. - -::: - -{{ kusama: Note that you cannot import Kusama Ledger accounts in Ledger Live. To see Kusama account balances, you must import your ledger account into a [**wallet**](./wallets). :kusama }} - -## Using on Polkadot-JS Apps - -### Loading Your Account - -:::info - -Ledger Live should be off while using Ledger with Polkadot-JS UI as it can interfere with normal -operation. - -::: - -You can import your Ledger account to [Polkadot Extension](https://polkadot.js.org/extension/) or to -the [Polkadot-JS UI](https://polkadot.js.org/apps/#/explorer). For instructions on how to import -Ledger accounts to the Polkadot Extension read through -[this support article](https://support.polkadot.network/support/solutions/articles/65000175387-how-to-add-your-ledger-through-the-polkadot-extension), -while if you want to import Ledger accounts to the Polkadot-JS UI you can consult -[this other article](https://support.polkadot.network/support/solutions/articles/65000170812-how-to-add-ledger-account-through-the-polkadot-js-ui). - -#### Derivation paths - -When adding a Ledger account using the extension or the UI, you will be asked to select an -`account type` and an `account index`. The first lets you select an account, while the second lets -you pick a derivation path from that account - think of it like a formula from which child accounts -are generated. When you are creating a -{{ polkadot: Polkadot :polkadot }}{{ kusama: Kusama :kusama }} ledger account for the first time on -Ledger Live with name {{ polkadot: `Polkadot 1` :polkadot }}{{ kusama: `Kusama 1` :kusama }}, this -can be added to Polkadot-JS using the 0/0 derivation path (i.e. account type = 0 and account index = -0). If you add a second account called -{{ polkadot: `Polkadot 2` :polkadot }}{{ kusama: `Kusama 2` :kusama }}, this will correspond to the -1/0 derivation path, and so on. We thus have multiple parent accounts that can be viewed and used in -both Ledger Live and Polkadot-JS. Additionally, we can use Polkadot-JS UI to create multiple -children accounts from each parent account. For example, -{{ polkadot: `Polkadot 1` :polkadot }}{{ kusama: `Kusama 1` :kusama }} with 0/0 derivation path can -have child 0/1, 0/2, etc. that can be used within the UI. However, such children accounts cannot be -used in Ledger Live, as it only scans through the parent accounts. So, remember that the balances on -the children accounts cannot be viewed, and you will not be able to transact with those accounts on -Ledger Live. - -#### Connecting your ledger device - -While using a ledger device to sign transactions, depending on your browser and its security -settings, you might need to confirm the USB connection through a popup like the one below: - -![Display the device connection popup](../assets/ledger/query-device.png) - -If you are adding your Ledger Nano for the first time, click on the "Unknown device" line and the -"Connect" button will become available. - -:::info Signature error message - -If you have already connected your device, but an error message appears before signing a -transaction, make sure you have opened the -{{ polkadot: Polkadot :polkadot }}{{ kusama: Kusama :kusama }} application on your Ledger Nano -device. Visit -[this support page](https://support.polkadot.network/support/solutions/articles/65000181994) for -more information about signing transactions using your ledger. - -::: - -### Confirming the Address on your Device - -To display your {{ polkadot: Polkadot :polkadot }}{{ kusama: Kusama :kusama }} ledger account -address on your Ledger Nano, you can follow the guidelines on -[this support article](https://support.polkadot.network/support/solutions/articles/65000181854-how-to-confirm-your-account-address-on-your-ledger-device). -Here you can scroll through and make sure the address matches what is displayed on -[Polkadot-JS UI](https://polkadot.js.org/apps/#/explorer). - -### Checking the Balance of Your Account - -There are a few methods to check the balance of your account. Check out -[this support article](https://support.polkadot.network/support/solutions/articles/65000169332-where-can-i-see-the-balance-of-my-account-) -for information. - -### Sending a Transfer - -General instructions to send a transfer can be found on -[this support page](https://support.polkadot.network/support/solutions/articles/65000170304-how-to-send-transfer-funds-out-of-your-dot-account-on-the-polkadot-js-ui). -To sign transactions with your Ledger nano check -[this support article](https://support.polkadot.network/support/solutions/articles/65000181994). - -### Receiving a Transfer - -To receive a transfer on the accounts stored on your Ledger device, you must provide the sender -(i.e. the payer) with your address. To do so, follow the instructions on -[this support page](https://support.polkadot.network/support/solutions/articles/65000181866-how-to-receive-dot-to-my-account-on-polkadot-js-ui). - -:::warning - -Before giving anyone your address, ensure it matches what's on the Ledger by -[confirming the address on your device](#confirming-the-address-on-your-device). Some malware will -intercept clicks and clipboard requests and can change your copied value in-flight, so being extra -vigilant around copy-paste operations makes sense. - -::: - -### Staking - -For staking using Ledger devices, check the section "How to stake using your Ledger" on -[this support article](https://support.polkadot.network/support/solutions/articles/65000168057-how-do-i-stake-nominate-on-polkadot-). - -### Removing Expired Democracy Locks - -Check out -[this support page](https://support.polkadot.network/support/solutions/articles/65000181870-how-to-remove-expired-democracy-locks) -the learn how to remove democracy locks after the end of a Governance referendum. - -**Please be advised**: Despite the Polkadot ledger application being compatible with both the Ledger -Nano S and the Ledger Nano X, none of the [Democracy](../maintain/maintain-guides-democracy.md) -extrinsics are available in the light version. The following -[repository by Zondax](https://github.com/Zondax/ledger-polkadot) lists the currently supported -Democracy extrinsics on the full ledger. - ## Ledger Developer Release :::warning @@ -235,11 +108,9 @@ they are made available on a developer release for testing purposes. After a suc review, the apps would be available for download and installation using [Ledger Live](https://www.ledger.com/ledger-live). As it takes some time for Ledger to audit and review the release, the app upgrade option may not be available on Ledger Live when the new runtime -is deployed on the network. If this happens, users cannot use Ledger devices with the Polkadot-JS -UI, and while signing for a transaction, will most likely incur the error message "txn version not -supported". Please do not panic if this happens, as there are solutions to this problem. Suppose you -cannot wait a few days until the app passes the Ledger audit, you can install the developer release -from the shell using the latest version published on +is deployed on the network. If this happens, users cannot use Ledger devices to sign transactions. +Suppose you cannot wait a few days until the app passes the Ledger audit, you can install the +developer release from the shell using the latest version published on [the Zondax GitHub repository](https://github.com/Zondax/ledger-polkadot/releases). ### Install the Developer Release diff --git a/docs/general/metadata.md b/docs/general/metadata.md index d56d117f0dc1..9e7187edceef 100644 --- a/docs/general/metadata.md +++ b/docs/general/metadata.md @@ -10,7 +10,7 @@ slug: ../metadata import Metadata from "./../../components/Metadata"; The `Metadata Explorer` tool helps visualize the metadata of various parachains by retrieving the -latest data directly from the chain using the [polkadot-js api](https://github.com/polkadot-js/api). +latest data directly from the chain using the [polkadot-js api](./polkadotjs.md#polkadot-js-api). The dropdown below allows you to update the chain selection to visualize. You can search all sub-categories using the provided search field. The information is categorized by the chains `Pallets`, `RPC` and `Runtime` information. diff --git a/docs/general/multisig-apps.md b/docs/general/multisig-apps.md index 36bc7f1f03de..7d91eb54c6a6 100644 --- a/docs/general/multisig-apps.md +++ b/docs/general/multisig-apps.md @@ -51,7 +51,7 @@ for more information about using [Multix](https://multix.chainsafe.io/) for mult The [Multix tool](https://multix.chainsafe.io/) is an easy-to-use interface to manage complex multisigs. The tool is part of [the open-source Polkadot/Kusama Tech Stack](https://wiki.polkadot.network/docs/build-open-source#user-interface). -Besides being user-friendly, Multix provides several benefits compared to the Polkadot-JS UI: +Besides being user-friendly, Multix provides several benefits: - When one person creates the multisig account, all the signatories see the multisig account on their interface. diff --git a/docs/general/polkadot-vault.md b/docs/general/polkadot-vault.md index 4f3af7551ced..3b9798d4cbe9 100644 --- a/docs/general/polkadot-vault.md +++ b/docs/general/polkadot-vault.md @@ -70,16 +70,9 @@ example, you can have an air-gapped laptop with the Subkey tool installed and ge there. The seed phrase of that account can be imported into the Vault App (Add Key Set > Recover Key Set). -We recommend importing a Vault account into the -[Polkadot-JS Browser Extension](./polkadotjs.md#polkadot-js-extension) or -[Parity Signer Companion](https://chrome.google.com/webstore/detail/parity-signer-companion/damllfnhhcbmclmjilomenbhkappdjgb). -Alternatively, you can import a Vault account directly into the Polkadot-JS UI but keep in mind that -clearing the cache of your browser will remove those accounts (this will not happen for accounts -imported into an extension). See the instructions in -[this article](https://support.polkadot.network/support/solutions/articles/65000184076-polkadot-vault-how-to-create-an-account) -to learn more about creating Vault accounts, and -[this article](https://support.polkadot.network/support/solutions/articles/65000184118-polkadot-vault-how-to-add-your-account-on-polkadot-js-ui) -on how to import them to the Polkadot extension or Polkadot-JS UI. +See the instructions in +[this support article](https://support.polkadot.network/support/solutions/articles/65000184076-polkadot-vault-how-to-create-an-account) +to learn more about creating Vault accounts. :::info diff --git a/docs/general/polkadotjs.md b/docs/general/polkadotjs.md index 9339f83cf794..849672b591fb 100644 --- a/docs/general/polkadotjs.md +++ b/docs/general/polkadotjs.md @@ -1,6 +1,6 @@ --- id: polkadotjs -title: Polkadot-JS +title: Polkadot-JS Tooling sidebar_label: Polkadot-JS Tooling description: The Polkadot-JS Tool Collection. keywords: [polkadotjs, polkadotjs apps, apps UI, extension] diff --git a/docs/general/staking-apps.md b/docs/general/staking-apps.md index e0b27e5cddff..9233ed8e8dea 100644 --- a/docs/general/staking-apps.md +++ b/docs/general/staking-apps.md @@ -32,8 +32,11 @@ Users can also create their nomination pools. The dashboard supports [Ledger](.. PolkaGate, and Enkrypt. The dashboard also supports [staking proxies](../learn/learn-proxies.md#staking-proxy). -You can find more information about the Polkadot staking dashboard on the -[dedicated page](./staking-dashboard.md). +You can find more information about the Polkadot staking dashboard on the dedicated +[wiki page](./staking-dashboard.md) and +[support articles](https://support.polkadot.network/support/solutions/folders/65000157523). + +Below a list of video tutorial about the Polkadot Staking Dashboard. diff --git a/docs/general/staking-dashboard.md b/docs/general/staking-dashboard.md index 6f3421b90eb3..a5b4d7d90d12 100644 --- a/docs/general/staking-dashboard.md +++ b/docs/general/staking-dashboard.md @@ -23,11 +23,10 @@ extension or a wallet to use it; you just need your Ledger device. only need to keep your Ledger apps up-to-date. Before using the dashboard, make sure you have a -{{ polkadot: Polkadot :polkadot }}{{ kusama: Kusama :kusama }} account in a Ledger device with the -{{ polkadot: Polkadot :polkadot }}{{ kusama: Kusama :kusama }} Ledger app installed, or a browser -extension such as the [Polkadot-JS Extension](./polkadotjs.md#polkadot-js-extension) or -[other third-party extensions](./wallets-and-extensions.md#browser-extensions) with a funded -{{ polkadot: Polkadot :polkadot }}{{ kusama: Kusama :kusama }} account. +[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 +[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-transaction-fees.md) and the @@ -47,8 +46,8 @@ dedicated to [staking](../learn/learn-staking.md) on Polkadot, [Westend](../maintain/maintain-networks.md#westend-test-network) (Polkadot's test network). The dashboard is not a wallet, meaning that you cannot transfer funds between accounts. To fund -accounts, you can use [supported wallets](./wallets) or the [Polkadot-JS UI](./polkadotjs-ui.md). -You can participate in staking by being a [nominator](../learn/learn-nominator.md) or a member of a +accounts, you can use [wallets and extension](./wallets-and-extensions.md). You can participate in +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. diff --git a/docs/learn/learn-account-advanced.md b/docs/learn/learn-account-advanced.md index 0572260d53e6..4b6a008ac153 100644 --- a/docs/learn/learn-account-advanced.md +++ b/docs/learn/learn-account-advanced.md @@ -49,9 +49,21 @@ them in the [address conversion tools](#address-conversion-tools) section. If you want to create and manage several accounts on the network using the same seed, you can use derivation paths. We can think of the derived accounts as child accounts of the root account created -using the original mnemonic seed phrase. Many -{{ polkadot: Polkadot :polkadot }}{{ kusama: Kusama :kusama }} key generation tools support hard and -soft derivation. For instance, if you intend to create an account to be used on the +using the original mnemonic seed phrase. + +### Soft and Hard Derivation + +A soft derivation allows someone to potentially "go backward” to figure out the initial account's +private key if they know the derived account's private key. It is also possible to determine that +different accounts generated from the same seed are linked to that seed. A hard derivation path does +not allow either of these - even if you know a derived private key, it's not feasible to figure out +the private key of the root address, and it's impossible to prove that the first account is linked +with the second. These derivation methods have their use cases, given that the private keys for all +the derived accounts are fully secure. Unless you have a specific need for a soft derivation, it is +recommended to generate the account using a hard derivation path. + +Many {{ polkadot: Polkadot :polkadot }}{{ kusama: Kusama :kusama }} key generation tools support +hard and soft derivation. For instance, if you intend to create an account to be used on the {{ polkadot: Polkadot :polkadot }}{{ kusama: Kusama :kusama }} chain, you can derive a **hard key** child account using **//** after the mnemonic phrase. @@ -75,12 +87,28 @@ For instance, `//bill//account//1` and `//john/polkadot/initial` are both valid. derived account, you must know both the seed and the derivation path, so you should either use a well-defined sequence (e.g. //0, //1, //2...) or be sure to write down any derivation paths you use. -:::info +See the [Subkey documentation](https://docs.substrate.io/reference/command-line-tools/subkey/) for +details and examples of derivation path formats. The Polkadot-JS Apps and Extension and Parity +Signer support custom derivation paths using the same syntax as Subkey. + +Some wallets will automatically add derivation paths to the end of the generated mnemonic phrase. +This will generate separate seeds for different paths, allowing separate signing keys with the same +mnemonic, e.g. `//polkadot` and `//kusama`. Although you may +correctly save the mnemonic phrase, using it in another wallet will generate the same addresses only +if both wallets use the same derivation paths. -It is only possible to generate a derived account by knowing the derivation path. +Polkadot and Kusama both have paths registered in the +[BIP44 registry](https://github.com/satoshilabs/slips/blob/master/slip-0044.md). + +:::warning + +You must have the _parent_ private key and the derivation path to arrive at the key for an address. +Only use custom derivation paths if you are comfortable with your knowledge of this topic. ::: +### Password Derivation + There is an additional type of derivation called password derivation. On Polkadot you can derive a **password key** account using **///** after the mnemonic phrase @@ -104,36 +132,16 @@ Password-derived account are as secure as the chosen password. ::: -### Soft vs. Hard Derivation - -A soft derivation allows someone to potentially "go backward” to figure out the initial account's -private key if they know the derived account's private key. It is also possible to determine that -different accounts generated from the same seed are linked to that seed. A hard derivation path does -not allow either of these - even if you know a derived private key, it's not feasible to figure out -the private key of the root address, and it's impossible to prove that the first account is linked -with the second. These derivation methods have their use cases, given that the private keys for all -the derived accounts are fully secure. Unless you have a specific need for a soft derivation, it is -recommended to generate the account using a hard derivation path. - -See the [Subkey documentation](https://docs.substrate.io/reference/command-line-tools/subkey/) for -details and examples of derivation path formats. The Polkadot-JS Apps and Extension and Parity -Signer support custom derivation paths using the same syntax as Subkey. - -Some wallets will automatically add derivation paths to the end of the generated mnemonic phrase. -This will generate separate seeds for different paths, allowing separate signing keys with the same -mnemonic, e.g. `//polkadot` and `//kusama`. Although you may -correctly save the mnemonic phrase, using it in another wallet will generate the same addresses only -if both wallets use the same derivation paths. - -Polkadot and Kusama both have paths registered in the -[BIP44 registry](https://github.com/satoshilabs/slips/blob/master/slip-0044.md). +### Account Derivation in Ledger Live -:::warning +Ledger Live will only show the main account with BIP44 path 44'/354'/0'/0'/0'. This means that if +you created a derived account with a derivation path 44'/354'/0'/0'/1' on a wallet or extension, it +will not be displayed on the Ledger Live App. Consequently, it is not possible to transact with +derived accounts using the Ledger Live App, but it is possible to do so using Polkadot-JS. Check +[the accounts page](../learn/learn-accounts.md) for more information about derived accounts and +derivation paths. -You must have the _parent_ private key and the derivation path to arrive at the key for an address. -Only use custom derivation paths if you are comfortable with your knowledge of this topic. - -::: +{{ kusama: Note that you cannot import Kusama Ledger accounts in Ledger Live. To see Kusama account balances, you must import your ledger account into a [**wallet**](./wallets). :kusama }} ## For the Curious: How Prefixes Work diff --git a/docs/learn/learn-guides-assets-create.md b/docs/learn/learn-guides-assets-create.md index 908dc097aa8a..4dc24051e9d0 100644 --- a/docs/learn/learn-guides-assets-create.md +++ b/docs/learn/learn-guides-assets-create.md @@ -1,9 +1,9 @@ --- id: learn-guides-assets-create -title: Creating Assets with the Asset Hub +title: Polkadot-JS Guides about Creating Assets sidebar_label: Creating Assets -description: Advanced How-to Guides about Creating Assets. -keywords: [asset hub, assets, statemine, statemint] +description: Polkadot-JS Guides about Creating Assets. +keywords: [asset hub, assets, statemine, statemint, polkadot-js] slug: ../learn-guides-assets-create --- @@ -29,7 +29,7 @@ assets held on the Asset Hub can be broadly categorized as For additional background on the Asset Hub check out [this support article](https://support.polkadot.network/support/solutions/articles/65000181800-what-is-statemint-and-statemine-and-how-do-i-use-them-). -## Creating Assets on the Asset Hub +## Creating Assets on the Asset Hub with Polkadot-JS :::info diff --git a/docs/learn/learn-guides-assets-ledger.md b/docs/learn/learn-guides-assets-ledger.md index 6a172add776f..4fe2e9e23780 100644 --- a/docs/learn/learn-guides-assets-ledger.md +++ b/docs/learn/learn-guides-assets-ledger.md @@ -1,9 +1,9 @@ --- id: learn-guides-assets-ledger -title: Using the Asset Hub Ledger App +title: Polkadot-JS Guides about Asset Hub Ledger App sidebar_label: Asset Hub Ledger App -description: Advanced How-to Guides about Ledger and the Asset Hub. -keywords: [asset hub, ledger, assets, statemine, statemint] +description: Polkadot-JS Guides about Ledger and the Asset Hub. +keywords: [asset hub, ledger, assets, statemine, statemint, polkadot-js] slug: ../learn-guides-assets-ledger --- diff --git a/docs/learn/learn-guides-bounties.md b/docs/learn/learn-guides-bounties.md index b051ea5ef5f3..bc60543106c5 100644 --- a/docs/learn/learn-guides-bounties.md +++ b/docs/learn/learn-guides-bounties.md @@ -1,15 +1,15 @@ --- id: learn-guides-bounties -title: How-to Guides for Bounties +title: Polkadot-JS Guides about Bounties sidebar_label: Bounties -description: Advanced How-to Guides for Bounties -keyword: [treasury, bounties, guides, child bounty] +description: Polkadot-JS Guides for Bounties +keyword: [treasury, bounties, guides, child bounty, polkadot-js] slug: ../learn-guides-bounties --- import RPC from "./../../components/RPC-Connection"; -For these guides, you will use the [Polkadot-JS UI](https://polkadot.js.org/apps/#/explorer). +See [this page](./learn-polkadot-opengov-treasury.md#bounties) to learn about Bounties. :::info Notify the Polkadot Direction Channel diff --git a/docs/learn/learn-guides-identity.md b/docs/learn/learn-guides-identity.md index 3395ad395668..a0000662a85e 100644 --- a/docs/learn/learn-guides-identity.md +++ b/docs/learn/learn-guides-identity.md @@ -1,16 +1,15 @@ --- id: learn-guides-identity -title: Identity How-to Guides +title: Polkadot-JS Guides about Identity sidebar_label: Identity -description: Advanced How-to Guides about Identity - Registrars and Sub-Identity. -keywords: [registrar, identity, sub-identity] +description: Polkadot-JS Guides about Identity. +keywords: [registrar, identity, sub-identity, polkadot-js] slug: ../learn-guides-identity --- This is an advanced guide that is relevant for entities that would like to become registrars or -would like to set sub-identities to an existing account with an identity. The -[learn identity](https://wiki.polkadot.network/docs/learn-identity) page provides information on how -to set an identity and have it verified. +would like to set sub-identities to an existing account with an identity. See +[this page](./learn-identity.md) to learn about how to set an identity and have it verified. ## Registrars diff --git a/docs/learn/learn-guides-ledger.md b/docs/learn/learn-guides-ledger.md new file mode 100644 index 000000000000..b8dd89cb1d07 --- /dev/null +++ b/docs/learn/learn-guides-ledger.md @@ -0,0 +1,118 @@ +--- +id: learn-guides-ledger +title: Polkadot-JS Guides for Ledger Devices +sidebar_label: Ledger +description: Polkadot-JS Guides for Ledger Devices. +keywords: [ledger, polkadot-js] +slug: ../learn-guides-ledger +--- + +## Loading Your Account + +:::info + +Ledger Live should be off while using Ledger with Polkadot-JS UI as it can interfere with normal +operation. + +::: + +You can import your Ledger account to [Polkadot Extension](https://polkadot.js.org/extension/) or to +the [Polkadot-JS UI](https://polkadot.js.org/apps/#/explorer). For instructions on how to import +Ledger accounts to the Polkadot Extension read through +[this support article](https://support.polkadot.network/support/solutions/articles/65000175387-how-to-add-your-ledger-through-the-polkadot-extension), +while if you want to import Ledger accounts to the Polkadot-JS UI you can consult +[this other article](https://support.polkadot.network/support/solutions/articles/65000170812-how-to-add-ledger-account-through-the-polkadot-js-ui). + +### Derivation paths + +When adding a Ledger account using the extension or the UI, you will be asked to select an +`account type` and an `account index`. The first lets you select an account, while the second lets +you pick a derivation path from that account - think of it like a formula from which child accounts +are generated. When you are creating a +{{ polkadot: Polkadot :polkadot }}{{ kusama: Kusama :kusama }} ledger account for the first time on +Ledger Live with name {{ polkadot: `Polkadot 1` :polkadot }}{{ kusama: `Kusama 1` :kusama }}, this +can be added to Polkadot-JS using the 0/0 derivation path (i.e. account type = 0 and account index = +0). If you add a second account called +{{ polkadot: `Polkadot 2` :polkadot }}{{ kusama: `Kusama 2` :kusama }}, this will correspond to the +1/0 derivation path, and so on. We thus have multiple parent accounts that can be viewed and used in +both Ledger Live and Polkadot-JS. Additionally, we can use Polkadot-JS UI to create multiple +children accounts from each parent account. For example, +{{ polkadot: `Polkadot 1` :polkadot }}{{ kusama: `Kusama 1` :kusama }} with 0/0 derivation path can +have child 0/1, 0/2, etc. that can be used within the UI. However, such children accounts cannot be +used in Ledger Live, as it only scans through the parent accounts. So, remember that the balances on +the children accounts cannot be viewed, and you will not be able to transact with those accounts on +Ledger Live. + +### Connecting your ledger device + +While using a ledger device to sign transactions, depending on your browser and its security +settings, you might need to confirm the USB connection through a popup like the one below: + +![Display the device connection popup](../assets/ledger/query-device.png) + +If you are adding your Ledger Nano for the first time, click on the "Unknown device" line and the +"Connect" button will become available. + +:::info Signature error message + +If you have already connected your device, but an error message appears before signing a +transaction, make sure you have opened the +{{ polkadot: Polkadot :polkadot }}{{ kusama: Kusama :kusama }} application on your Ledger Nano +device. Visit +[this support page](https://support.polkadot.network/support/solutions/articles/65000181994) for +more information about signing transactions using your ledger. + +::: + +## Confirming the Address on your Device + +To display your {{ polkadot: Polkadot :polkadot }}{{ kusama: Kusama :kusama }} ledger account +address on your Ledger Nano, you can follow the guidelines on +[this support article](https://support.polkadot.network/support/solutions/articles/65000181854-how-to-confirm-your-account-address-on-your-ledger-device). +Here you can scroll through and make sure the address matches what is displayed on +[Polkadot-JS UI](https://polkadot.js.org/apps/#/explorer). + +## Checking the Balance of Your Account + +There are a few methods to check the balance of your account. Check out +[this support article](https://support.polkadot.network/support/solutions/articles/65000169332-where-can-i-see-the-balance-of-my-account-) +for information. + +## Sending a Transfer + +General instructions to send a transfer can be found on +[this support page](https://support.polkadot.network/support/solutions/articles/65000170304-how-to-send-transfer-funds-out-of-your-dot-account-on-the-polkadot-js-ui). +To sign transactions with your Ledger nano check +[this support article](https://support.polkadot.network/support/solutions/articles/65000181994). + +## Receiving a Transfer + +To receive a transfer on the accounts stored on your Ledger device, you must provide the sender +(i.e. the payer) with your address. To do so, follow the instructions on +[this support page](https://support.polkadot.network/support/solutions/articles/65000181866-how-to-receive-dot-to-my-account-on-polkadot-js-ui). + +:::warning + +Before giving anyone your address, ensure it matches what's on the Ledger by +[confirming the address on your device](#confirming-the-address-on-your-device). Some malware will +intercept clicks and clipboard requests and can change your copied value in-flight, so being extra +vigilant around copy-paste operations makes sense. + +::: + +## Staking + +For staking using Ledger devices, check the section "How to stake using your Ledger" on +[this support article](https://support.polkadot.network/support/solutions/articles/65000168057-how-do-i-stake-nominate-on-polkadot-). + +## Removing Expired Democracy Locks + +Check out +[this support page](https://support.polkadot.network/support/solutions/articles/65000181870-how-to-remove-expired-democracy-locks) +the learn how to remove democracy locks after the end of a Governance referendum. + +**Please be advised**: Despite the Polkadot ledger application being compatible with both the Ledger +Nano S and the Ledger Nano X, none of the [Democracy](../maintain/maintain-guides-democracy.md) +extrinsics are available in the light version. The following +[repository by Zondax](https://github.com/Zondax/ledger-polkadot) lists the currently supported +Democracy extrinsics on the full ledger. diff --git a/docs/learn/learn-guides-polkadot-opengov.md b/docs/learn/learn-guides-polkadot-opengov.md index 23bf29c8e287..fcd430712f5a 100644 --- a/docs/learn/learn-guides-polkadot-opengov.md +++ b/docs/learn/learn-guides-polkadot-opengov.md @@ -1,16 +1,15 @@ --- id: learn-guides-polkadot-opengov -title: Polkadot OpenGov How-to Guides +title: Polkadot-JS Guides about OpenGov sidebar_label: OpenGov -description: Advanced How-to Guides about Polkadot OpenGov. -keywords: [opengov, polkadot opengov, referenda, cancel] +description: Polkadot-JS Guides about Polkadot OpenGov. +keywords: [opengov, polkadot opengov, referenda, cancel, polkadot-js] slug: ../learn-guides-polkadot-opengov --- import RPC from "./../../components/RPC-Connection"; -This page is for advanced users of Polkadot OpenGov. If you would learn more about OpenGov see the -[dedicated page](./learn-polkadot-opengov.md). +See [this page](./learn-polkadot-opengov.md) to learn about Polkadot OpenGov. This guide will instruct token holders how to propose and vote on public referenda using the Referenda module (OpenGov). Below are a few links to stay informed and directly engage with the @@ -162,24 +161,8 @@ For an overview of how delegation works in Polkadot OpenGov, check out the [Multirole Delegation](../learn/learn-polkadot-opengov.md#multirole-delegation) section on the [Learn Polkadot OpenGov](../learn/learn-polkadot-opengov.md) page. -### Delegation Dashboard - -To make multi-role delegation easy and intuitive, -[Delegation Dashboard](https://delegation.polkadot.network/) provides an interactive interface that -displays the list of delegates and their details. The video tutorial below walks through the -features of the Delegation Dashboard and shows how to perform multi-role delegation. - -[![Delegation Dashboard Tutorial](https://img.youtube.com/vi/RapBYZc5ZPo/0.jpg)](https://www.youtube.com/watch?v=RapBYZc5ZPo) - -For detailed instructions on how to delegate your voting power using dashboard, check -[this support guide.](https://support.polkadot.network/support/solutions/articles/65000184123-polkadot-opengov-how-to-delegate-your-voting-power) -If you like to use Polkadot-JS UI for performing multi-role delegation, the instructions are -available -[here](https://support.polkadot.network/support/solutions/articles/65000184776-polkadot-js-ui-how-to-delegate-your-voting-power-on-polkadot-opengov). - -Polkassembly also provides an engaging interface to interact with governance in OpenGov along with -an alternative interface for delegation at -[polkadot.polkassembly.io/delegation](https://polkadot.polkassembly.io/delegation) +Instructions to do delegations with Polkadot-JS are also available on the +[Support Pages](https://support.polkadot.network/support/solutions/articles/65000184776-polkadot-js-ui-how-to-delegate-your-voting-power-on-polkadot-opengov). ### Delegate Votes diff --git a/docs/learn/learn-guides-staking-pools.md b/docs/learn/learn-guides-staking-pools.md index d318e7ff0138..eda9a9c2ece0 100644 --- a/docs/learn/learn-guides-staking-pools.md +++ b/docs/learn/learn-guides-staking-pools.md @@ -1,25 +1,17 @@ --- id: learn-guides-staking-pools -title: Nomination Pools How-to Guides +title: Polkadot-JS Guides for Pool Creators sidebar_label: Nomination Pools -description: Advanced How-to Guides about Nomination Pools. -keyword: [nominate, stake, staking, pools, create, destroy, claim, rewards] +description: Polkadot-JS Guides about Nomination Pools. +keyword: [stake, staking, pools, create, destroy, claim, rewards, polkadot-js] slug: ../learn-guides-staking-pools --- import RPC from "./../../components/RPC-Connection"; -This page is for pool creators and maintainers. If you like to participate in staking through -nomination pools, please navigate to this page on -[how to join a nomination pool.](https://support.polkadot.network/support/solutions/articles/65000182376-staking-dashboard-how-to-join-a-nomination-pool) +See [this page](./learn-nomination-pools.md) to learn about nomination pools. -See the video tutorial below to learn how to create a pool, set the pool commission, set claim -permissions, claim rewards on behalf of another account, and destroy a pool using the Polkadot -Staking Dashboard. - -[![Create and manage pools](https://img.youtube.com/vi/aTFWhwy_Mxg/0.jpg)](https://www.youtube.com/watch?v=aTFWhwy_Mxg) - -## Pool Creation +## Pool Creation with Polkadot-JS :::info @@ -59,7 +51,7 @@ Apps UI. ![Nomination Pool Roles](../assets/staking/Nomination-Pools-7.png) -## Pool Upkeep +## Pool Upkeep with Polkadot-JS The nominator can update the pool’s validator selection. On Polkadot JS Apps UI, navigate to [Network > Staking > Accounts page](https://polkadot.js.org/apps/#/staking/actions) and click on @@ -72,7 +64,7 @@ account. The root and bouncer can update the pool’s state to blocked through `setState` extrinsic and kick members by calling `unbond` and `withdrawUnbonded`. (The state can also be toggled back to open). -## Pool Destruction +## Pool Destruction with Polkadot-JS :::info @@ -99,7 +91,7 @@ anyone can help all the members exit. The pool is destroyed once the depositor withdraws, no members belong to the pool, and all the pool’s resources are wiped from the state. -## Claim Rewards for Other Pool Members +## Claim Rewards for Other Pool Members with Polkadot-JS As a pool member you can claim rewards for any other members who set their [claim permissions](./learn-nomination-pools.md#claim-permissions) to one of the _permissionless_ diff --git a/docs/learn/learn-guides-staking.md b/docs/learn/learn-guides-staking.md index 5e861739263e..33cbca875a17 100644 --- a/docs/learn/learn-guides-staking.md +++ b/docs/learn/learn-guides-staking.md @@ -1,19 +1,17 @@ --- id: learn-guides-staking -title: How-to Guides for Nominators +title: Polkadot-JS Guides For Nominators sidebar_label: Staking -description: Advanced How-to Guides for Nominators. -keyword: [nominate, stake, staking, pools, create, destroy, claim, rewards] +description: Polkadot-JS Guides for Nominators. +keyword: [nominate, stake, staking, claim, rewards, polkadot-js] slug: ../learn-guides-staking --- import RPC from "./../../components/RPC-Connection"; -This page focuses on the advanced staking features of the network. If you like to learn about -staking, check this page on the -[introduction to staking.](https://wiki.polkadot.network/docs/learn-staking) +See [this page](./learn-staking.md) to learn about staking. -## Claiming Rewards with the Polkadot-JS UI +## Claiming Rewards with Polkadot-JS Anyone can trigger a payout for any validator, as long as they are willing to pay the transaction fee. Someone must submit a transaction with a validator ID and an era index. diff --git a/docs/learn/learn-guides-treasury.md b/docs/learn/learn-guides-treasury.md index 130457a11620..1df3df0a91d6 100644 --- a/docs/learn/learn-guides-treasury.md +++ b/docs/learn/learn-guides-treasury.md @@ -1,14 +1,16 @@ --- id: learn-guides-treasury -title: Polkadot Treasury How-to Guides +title: Polkadot-JS Guides about the Treasury sidebar_label: Treasury -description: Advanced How-to Guides about requesting funds from the Polkadot Treasury. -keywords: [opengov, polkadot opengov, referenda, treasury, tipps, bounties] +description: Polkadot-JS Guides about the Polkadot Treasury. +keywords: [opengov, polkadot opengov, referenda, treasury, tipps, polkadot-js] slug: ../learn-guides-treasury --- import RPC from "./../../components/RPC-Connection"; +See [this page](./learn-polkadot-opengov-treasury.md) to learn about the Polkadot Treasury. + ## Creating a Treasury Proposal Your proposal should address a problem, outline a goal, give a detailed account of how you will diff --git a/docs/learn/learn-guides-vault.md b/docs/learn/learn-guides-vault.md index 42ee4b6a5566..e2b2a63f83a2 100644 --- a/docs/learn/learn-guides-vault.md +++ b/docs/learn/learn-guides-vault.md @@ -1,22 +1,33 @@ --- id: learn-guides-vault -title: Vault How-to Guides +title: Polkadot-JS Guides about the Vault App sidebar_label: Polkadot Vault -description: Advanced How-to Guides about Polkadot Vault. -keywords: [parity signer, signer, polkadot vault] +description: Polkadot-JS Guides about Polkadot Vault. +keywords: [parity signer, signer, polkadot vault, polkadot-js] slug: ../learn-guides-vault --- -:::danger This page is for developers and power users only +:::info -By requesting the chain specification and metadata you trust the specific endpoint you are using -(unless you are using you own node). +These guides apply to both Parity Signer and Polkadot Vault apps. ::: -:::info +## Import Vault Accounts into Polkadot-JS -These guides apply to both Parity Signer and Polkadot Vault apps. +See +[this support article](https://support.polkadot.network/support/solutions/articles/65000184118-polkadot-vault-how-to-add-your-account-on-polkadot-js-ui) +to import a Polkadot Vault account into the +[Polkadot-JS Browser Extension](../general/polkadotjs.md#polkadot-js-extension) or +[Parity Signer Companion](https://chrome.google.com/webstore/detail/parity-signer-companion/damllfnhhcbmclmjilomenbhkappdjgb). +Accounts added to those extensions will be injected into the Polkadot-JS UI. + +## Do Your Own Chain Spec and Metadata Update + +:::danger This section is for developers and power users only + +By requesting the chain specification and metadata you trust the specific endpoint you are using +(unless you are using you own node). ::: @@ -25,9 +36,9 @@ page (to create the Chain Spec QR code and the metadata QR code fountain) and [Metadata Portal](https://github.com/paritytech/metadata-portal) Github page (to embed the Chain Spec and Metadata into a portal). -## Chain Specification +### Chain Specification -### Chain Spec QR +#### Chain Spec QR To add more chains on the Vault app you can follow the instructions [here](https://paritytech.github.io/parity-signer/tutorials/Add-New-Network.html#add-network-specs). @@ -42,7 +53,7 @@ Kusama. This will create the file `sign_me_add_specs_statemine_sr25510` under th `files/in_progress` folder. See {{ polkadot: [this GitHub page](https://github.com/polkadot-js/apps/blob/089fd77b14169749e35e073a93f7e7276963009c/packages/apps-config/src/endpoints/productionRelayPolkadot.ts) for a list of all endpoints listed in the Polkadot-JS UI. :polkadot }}{{ kusama: [this GitHub page](https://github.com/polkadot-js/apps/blob/089fd77b14169749e35e073a93f7e7276963009c/packages/apps-config/src/endpoints/productionRelayKusama.ts) for a list of all endpoints listed in the Polkadot-JS UI. :kusama}} -### Generating Signature +#### Generating Signature :::danger Use a hot account @@ -62,7 +73,7 @@ signature similar to that below: `0xc4ce72db959000b6166af96d3bda55a927fd837747bf1bf1ae8a69e57c9ef37c25a88707c47b105a9eb1fbcf9345680eff57eb978cf73919506f6c738834e78a` -### Signing Chain Spec +#### Signing Chain Spec Now, go back to the `/generate_message` folder and type the following: @@ -72,12 +83,12 @@ where `PUBLIC KEY` is the public key of the account with seed `"YOUR SEED PHRASE is the signature generated in the previous step. Running the code above will create the file `add_specs_statemine-sr25519` under the `files/completed` folder. -## Metadata Updates +### Metadata Updates Similarly to what we did for the chain specification, we now generate and sign the Asset Hub metadata. -### Metadata QR Fountain +#### Metadata QR Fountain To update the chain metadata for the Asset Hub specs on the Vault app you can follow the instructions @@ -99,7 +110,7 @@ Note that the name of the file changes according to the network version. That is ::: -### Generating Signature +#### Generating Signature :::danger Use a hot account @@ -127,7 +138,7 @@ folder. The signature changes as well. ::: -### Signing Metadata +#### Signing Metadata Now, go back to the `/generate_message` folder and type the following: @@ -137,16 +148,16 @@ where `PUBLIC KEY` is the public key of the account with seed `"YOUR SEED PHRASE is the signature generated in the previous step. Running the code above will create the file `load_metadata_statemineV9370` under the `files/completed` folder. -## Add Chain & Update Metadata +### Add Chain & Update Metadata You can open `add_specs_statemine-sr25519` on your browser (just drag the file on an open tab). This is a .png file containing the QR code to add the Asset Hub chain specification into the Vault App. You can do the same with the `load_metadata_statemineV9370`. This is a .apng file containing the QR code fountain to do the metadata update for the Asset Hub on Kusama. -## Metadata Portal +### Metadata Portal -### Modify `config` File +#### Modify `config` File Alternatively, you can add the chain specification QR code and the metadata QR code fountain in a metadata portal. Briefly, fork the @@ -173,7 +184,7 @@ genesis_hash = "0x48239ef607d7928874027a43a67689209727dfb3d3dc5e5b03a39bdc2eda77 For each additional chain, you need to add the respective information. Information about the genesis hash can be found on the Polkadot-JS UI > connect to the relevant chain > Developer > Chain State. -### Rename Chain's Files +#### Rename Chain's Files Rename the signed chain specification and metadata files as follow: @@ -187,7 +198,7 @@ chain and `version` is the version of the metadata. Add the renamed files to the `/public/qr folder` within the Metadata Portal repository. -### Run Portal +#### Run Portal Open the terminal within the Metadata Portal repository and run `make updater`. Then run `make collector`; this will create the `_latest.apng` files for each of the chains (removed by the diff --git a/polkadot-wiki/sidebars.js b/polkadot-wiki/sidebars.js index 6b384252de5e..27812d171fbb 100644 --- a/polkadot-wiki/sidebars.js +++ b/polkadot-wiki/sidebars.js @@ -296,6 +296,55 @@ module.exports = { items: [ "general/polkadotjs", "general/polkadotjs-ui", + { + type: "category", + label: "Polkadot-JS Guides", + description: 'Polkadot-JS Guides about Staking, Asset Hub, Vault App, and more.', + link: { + type: 'generated-index', + title: 'Polkadot-JS Guides', + description: 'Polkadot-JS Guides about Staking, Asset Hub, Ledger, Vault App, and more.', + slug: '/learn-guides-index', + }, + items: [ + { + type: "category", + label: "Staking", + description: 'Polkadot-JS Guides about Staking.', + link: { + type: 'generated-index', + title: 'Polkadot-JS Guides about Staking', + description: 'Polkadot-JS Guides about Staking.', + slug: '/learn-guides-staking-index', + }, + items: [ + "learn/learn-guides-staking", + "learn/learn-guides-staking-pools", + ], + }, + "learn/learn-guides-polkadot-opengov", + "learn/learn-guides-treasury", + "learn/learn-guides-bounties", + "learn/learn-guides-identity", + "learn/learn-guides-ledger", + "learn/learn-guides-vault", + { + type: "category", + label: "Asset Hub", + description: 'Polkadot-JS Guides about the Asset Hub.', + link: { + type: 'generated-index', + title: 'Advanced Guides for Asset Hub', + description: 'Polkadot-JS guides about the Asset Hub.', + slug: '/learn-guides-assets-index', + }, + items: [ + "learn/learn-guides-assets-create", + "learn/learn-guides-assets-ledger", + ], + }, + ], + }, ], }, { @@ -372,54 +421,6 @@ module.exports = { "learn/learn-nft-pallets", "learn/learn-cryptography", 'learn/learn-phragmen', - { - type: "category", - label: "How-to Guides", - description: 'Advanced Guides about Staking, Asset Hub, Vault App, and more.', - link: { - type: 'generated-index', - title: 'Advanced Guides', - description: 'Advanced how-to guides using the Polkadot-JS User Interface.', - slug: '/learn-guides-index', - }, - items: [ - { - type: "category", - label: "Staking", - description: 'Advanced How-to Guides about Staking.', - link: { - type: 'generated-index', - title: 'Advanced Guides for Staking', - description: 'Advanced how-to guides about Staking.', - slug: '/learn-guides-staking-index', - }, - items: [ - "learn/learn-guides-staking", - "learn/learn-guides-staking-pools", - ], - }, - "learn/learn-guides-polkadot-opengov", - "learn/learn-guides-treasury", - "learn/learn-guides-bounties", - "learn/learn-guides-identity", - { - type: "category", - label: "Asset Hub", - description: 'Advanced How-to Guides about the Asset Hub.', - link: { - type: 'generated-index', - title: 'Advanced Guides for Asset Hub', - description: 'Advanced how-to guides about the Asset Hub.', - slug: '/learn-guides-assets-index', - }, - items: [ - "learn/learn-guides-assets-create", - "learn/learn-guides-assets-ledger", - ], - }, - "learn/learn-guides-vault", - ], - }, ], }, {