Polkadot Vault: How to Add a New Chain and Update the Metadata Print
Modified on: Mon, 20 Mar, 2023 at 12:39 PM
Polkadot Vault is the new mobile app developed by Parity that replaces Parity Signer. It's redesigned with additional functionality and for a better and more streamlined user experience. Polkadot Vault is currently available only on iOS.
In this article, you will learn how to add additional chains to Polkadot Vault and update their metadata.
‼️ IMPORTANT In order for Polkadot Vault to decode and sign transactions it needs to have the metadata of the latest runtime version for the specific chain.
⛔️ READ THIS FIRST! Make sure that you explicitly trust the source of the chain spec and metadata. Adding metadata from an untrusted source could lead to loss of funds! The instructions in this article are provided with the assumption that you trust the source of the chain spec and metadata. Web3 Foundation does not endorse third-party metadata, with the exception of the ones provided by Parity.
TABLE OF CONTENTS
- Metadata updates
- How to add a new chain
There are three situations when you need to update the metadata:
- When you want to sign a transaction for the first time with one of the provided chains (Polkadot, Kusama, Westend)
- When you add a new chain (see instructions in the next section)
- When there is a new runtime version for the chain you are trying to use
If you see the following message when you try to sign a transaction, it means that Polkadot Vault doesn't have the metadata to decode and sign the transaction. In that case, you need to update the metadata.
How to update the metadata
In this example, we update the metadata for Polkadot, but the instructions are the same for any other chain you may have added, with the potential exception of the metadata source (see next section).
1. Navigate to Parity's metadata portal and select Polkadot on the sidebar.
2. Open the Polkadot Vault app on your phone and click on the "Scanner" tab.
3. Scan the QR fountain. Keep your phone as still as possible until the progress bar fills.
4. In the next screen you can see the issuer's details and the version of the metadata you are about to add. Click on "Approve".
That's it! Now you can sign transactions with your Polkadot accounts. If you haven't added your account on Polkadot-JS UI yet, check this article for instructions.
How to add a new chain
Polkadot Vault supports three chains out of the box: Polkadot, Kusama, and Westend. But you can add additional chains if you can scan a trusted spec QR code and metadata QR fountain.
Currently, there exists one metadata portal that supports a plethora of Substrate chains, curated by Nova wallet. Alternatively, if you are a technically-oriented user, you can create your own QR codes and metadata portal.
Below we provide instructions based on Nova's metadata portal, but the same instructions apply to any other source.
1. Navigate to Nova's metadata portal and select the chain you want to add from the sidebar. In this example, we'll add Acala to Polkadot Vault.
2. Navigate to the "Chain Specs" tab.
3. Open Polkadot Vault and click on the "Scanner" tab. This will open your phone's camera.
4. Scan the spec QR code.
5. On the screen that opens up you can see the details of the issuer and the chain you are about to add. Click "Approve," and the chain is added!
6. Finally, navigate back to the "Metadata" tab on the metadata portal and update the metadata as described in the previous section.
How to generate an account for a newly added chain
‼️ IMPORTANT The instructions below concern any key sets (accounts) that you have created before adding the new chain. Any key sets you create after will automatically have access to these chains. So, it might be a good idea to add all the chains you plan to use prior to creating or restoring your accounts.
1. Navigate to the home screen and select your key set (account).
2. Then click on the "Settings" icon on the right and select the chains you want to enable and click "Done".
ℹ️ GOOD TO KNOW This selection applies to all key sets (accounts) you have added to Polkadot Vault.
3. Then click on the plus (+) sign on the top right.
4. On the next screen click on "Network" and select the chain you want to create an account for. In this example we select Acala.
5. Then click in the field under "Derivation Path".
6. On the next screen, delete the two dashes (//) that are added automatically under "path name" and click "Done".
7. Then click on "Create Derived Key". Enter your phone's PIN.
8. Finally, check the checkbox "I have written down my derivation path" (which in this case is empty) and click "Done". You have created a new address for your account on that chain!
You are now ready to add your account for that chain on Polkadot-JS UI and sign transactions with it! Check this article if you want to know how to enable your account on multiple chains.
Did you find it helpful? Yes NoSend feedback
Disclaimer: We always strive to provide you with the best support we can and we take all care to ensure that our instructions are accurate and concise. However, following these instructions properly, as well as the general management of your accounts and funds, is ultimately your responsibility. Web3 Foundation cannot be held liable for any accidental loss of funds or any other damage you might incur.