Skip to content

Commit

Permalink
Add info Account Derivation Vault (#5423)
Browse files Browse the repository at this point in the history
* added new section

* added information

* added banner with link

* Update docs/learn/learn-account-advanced.md

Co-authored-by: Bill Laboon <[email protected]>

* Update docs/learn/learn-account-advanced.md

Co-authored-by: Bill Laboon <[email protected]>

* added Bill's feedback

---------

Co-authored-by: Bill Laboon <[email protected]>
  • Loading branch information
filippoweb3 and laboon authored Dec 15, 2023
1 parent ce73aa3 commit 22a8c69
Showing 1 changed file with 40 additions and 1 deletion.
41 changes: 40 additions & 1 deletion docs/learn/learn-account-advanced.md
Original file line number Diff line number Diff line change
Expand Up @@ -319,7 +319,7 @@ Password-derived account are as secure as the chosen password.

:::

### Account Derivation in Ledger Live
### Account Derivation on [Ledger](../general/ledger.md) Live

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
Expand All @@ -330,6 +330,45 @@ 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 }}

### Account Derivation on [Subkey](#creating-accounts-with-subkey) and [Polkadot Vault](../general/polkadot-vault.md)

The Subkey tool and Polkadot Vault App use the following Polkadot Standard Hard Derivation scheme:

- `//network` as the primary account for `network`, named according to `network`'s named chain
specification
- `//network//0`, `//network//1`, ... as the secondary high-security accounts for `network`

For example, the Vault app will generate a new account from a `SEED PHRASE`, and for each network
will create a derived child account from that seed. For the default networks Polkadot, Kusama and
Westend the derivation path will be:

- `SEED PHRASE//polkadot` for Polkadot, with `SEED PHRASE//polkadot//0` as the first secondary
high-security account
- `SEED PHRASE//kusama` for Kusama, with `SEED PHRASE//kusama//0` as the first secondary
high-security account
- `SEED PHRASE//westend` for Westend, with `SEED PHRASE//westend//0` as the first secondary
high-security account

Additionally, although it is not strictly necessary, users can adopt the following good practice
scheme:

- `//network//pub` as the primary high-security public account for `network` (the one the user is
happy to be associated with their "real" ID)
- `//network//pub//0`, `//network//pub//0`, ... as the secondary high-security public accounts for
`network`
- `//network//hot` as the primary low-security account for `network` (the one whose secret key the
user exports from the Vault app to carry on an internet-connected device)
- `//network//hot//0`, `//network//hot//1`, ... as the secondary low-security accounts for
`network`

:::info

For more information about account derivation best practices, see
[this post](https://forum.polkadot.network/t/polkadot-standards-proposal-psp-to-define-hierarchical-deterministic-hd-key-derivation-paths/2941/2)
on the Polkadot Forum.

:::

## System Accounts

As the word suggests, system accounts are used by the system. They are used, for example, for the
Expand Down

0 comments on commit 22a8c69

Please sign in to comment.