Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update Vara's wiki #33

Merged
merged 3 commits into from
Sep 8, 2023
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
60 changes: 33 additions & 27 deletions docs/account/create-account.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -6,12 +6,12 @@ sidebar_label: Create account

A Substrate account enables connection to applications across Polkadot, Kusama and their Parachains. There are several ways to generate a Substrate account described in this article, depending on whether you are using a desktop or a mobile device.

The Vara Network is substrate-based, which means that any keypair compatible with the sr25519 will also work on Vara.
The Vara Network is Substrate-based, which means that any keypair compatible with the sr25519 will also work on Vara.

## Key information and security

For most users, the use of popular and reliable wallets will be enough.
If you need to create a cold wallet for storing funds, then you should pay attention to [Parity Signer](parity-signer.mdx) (in the future we will also add Ledger support)
If you need to create a cold wallet for storing funds, then you should pay attention to [Polkadot Vault](polkadot-vault.mdx) (previously Parity Signer). In the future we will also add Ledger support.

There are two key features that make up an account - an address and a key (keypair):

Expand All @@ -32,6 +32,34 @@ You should never store your seed on a device that is, or ever will be, connected

Your account's JSON file is encrypted with a password. This means that while you can import into any wallet, you will need to use the password to do so successfully. As there is this additional layer of security - a password - you don't have to be as cautious about securing it. However, it's worth using highly secure passwords that are not used for anything else. It would be best if you made a note of this password offline.

## Via SubWallet

SubWallet is the comprehensive non-custodial wallet solution for Polkadot, Substrate & Ethereum ecosystems. With the mission of bringing users closer to Web3, SubWallet's vision is to become a Web3 multiverse gateway through which users can enjoy multichain services with utmost ease and absolute security. Connecting and using blockchain-based applications is smoother than ever with SubWallet Browser Extension & SubWallet Mobile App.

1. Install SubWallet extension & mobile app [here](https://subwallet.app/download.html).

2. Open SubWallet by clicking on the logo in the browser menu bar.

3. Click the `Create new account` button:

![img alt](./img/subwallet-1.png)

4. Create a master password and click `Continue`.

:::note
SubWallet cannot help you restore the password once it is lost as the wallet is non-custodial. You can recover your account using the seed if you forget your master password.
:::

![img alt](./img/subwallet-2.png)

5. Keep your seed phrase in a safe place and never disclose it to anyone. After you have saved it, click `I have kept it somewhere safe` to move on.

![img alt](./img/subwallet-3.png)

6. Congratulations, your wallet has been successfully created!

![img alt](./img/subwallet-4.png)

## Via Talisman

`Talisman` is a popular non-custodial wallet for creating and managing Substrate accounts. Being connected to Web3 applications across various networks, Talisman browser extension allows to store, send and receive assets. The Talisman browser extension is one of the easiest and secure ways of creating a Substrate account.
Expand All @@ -56,28 +84,6 @@ And that's it. Your wallet has been created:
Don't forget to save your seed phrase by clicking the `Backup Now` button. If you will skip this step, you can do it later from Settings.
:::

## Via Subwallet

Subwallet is another advanced wallet for managing Substrate as well as EVM accounts.

1. To install Subwallet follow this [link](https://subwallet.app/download.html)

2. Open Subwallet by clicking on its logo in the browser menu bar.

3. Click the `Create new account` button:

![img alt](./img/subwallet-1.png)

4. Select the type of account you want to create - Subwallet allows you to create Substrate-like and Ethereum accounts at once. Copy your seed phrase and keep it in the safe place:

![img alt](./img/subwallet-2.png)

5. Provide your password in the next step. And click `Add the account with the generated seed`:

![img alt](./img/subwallet-3.png)

Congratulations, your wallet has been successfully created!

## Via Polkadot.js browser extension

The polkadot.js browser extension is the original application created by Parity Technologies for managing Substate accounts. This method involves installing the polkadot.js plugin and using it as a "virtual vault" that's separate from your browser to store your private keys and sign transactions.
Expand Down Expand Up @@ -112,9 +118,9 @@ You've now successfully created a new account using the polkadot.js browser exte

If you need access to your accounts on a mobile device, then you can use the following mobile wallets for the Polkadot/Kusama ecosystem:

[![img alt](./img/nova-logo.png)](https://novawallet.io/)
[![img alt](./img/subwallet-logo2.png)](https://subwallet.app/)

[![img alt](./img/subwallet-logo.png)](https://subwallet.app/)
[![img alt](./img/nova-logo.png)](https://novawallet.io/)

All supported wallets you can check [here](https://wiki.polkadot.network/docs/build-wallets).

Expand Down Expand Up @@ -157,7 +163,7 @@ And then `import` the generated seed phrase into any convenient wallet.

#### Does vara support hard wallets?

> Yes! At the moment Vara supports [Parity Signer](parity-signer.mdx). Also in the future we will support Leger.
> Yes! At the moment Vara supports [Parity Signer](polkadot-vault.mdx). Also in the future we will support Leger.

#### How to get your address in the Vara Network format?

Expand Down
Binary file modified docs/account/img/subwallet-1.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified docs/account/img/subwallet-2.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified docs/account/img/subwallet-3.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/account/img/subwallet-4.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file removed docs/account/img/subwallet-logo.png
Binary file not shown.
Binary file added docs/account/img/subwallet-logo1.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/account/img/subwallet-logo2.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/account/img/subwallet-polkadot-vault.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
113 changes: 0 additions & 113 deletions docs/account/parity-signer.mdx

This file was deleted.

125 changes: 125 additions & 0 deletions docs/account/polkadot-vault.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,125 @@
---
title: Polkadot Vault (formerly Parity Signer)
sidebar_position: 2
sidebar_label: Polkadot Vault
---

import googleURL from './img/google-play-badge.png';
import appleURL from './img/app-store-badge.png';

# Vara cold storage via Polkadot Vault (formerly Parity Signer)

Polkadot Vault allows you to turn any mobile device based on Android or iOS into a real cold wallet. Your private keys are kept secure offline at all times and transactions are signed in an air-gapped way via QR-codes. A huge advantage is the completely open and transparent source code of [the product](https://github.com/paritytech/parity-signer).

Vara Network completely supports working with Polkadot Vault.

## Installation

There are several ways to get the Polkadot Vault.

Download from the application store for your device:

<div align="left">
<a href="https://play.google.com/store/apps/details?id=io.parity.signer">
<img src={googleURL} alt="Play Market" />
</a>{' '}
<a href="https://itunes.apple.com/us/app/parity-signer/id1218174838">
<img src={appleURL} alt="Apple Store" />
</a>
</div>

Download directly from the GitHub:

https://github.com/paritytech/parity-signer/releases

## Create your keys

:::info
Once Polkadot Vault is installed, your device should never go online. You must turn off or even physically remove the smartphone's Wifi, Mobile Network, and Bluetooth to ensure that the mobile phone containing these accounts will not be exposed to any online threat. Switching to airplane mode suffices in many cases.
:::

1. Go offline, open your Polkadot Vault application, accept Privacy Policy, create your PIN code.

2. Click the `New seed` button to generate and store your private keys. Backup your seed phrase on paper or try other reliable methods.

## Add Vara Network

To sign messages/transactions, and transfer funds to and from Vara account you need to add Vara Network into the app.

1. Open your Polkadot Vault and tap the `scan` button

2. Go to [Metadata Portal](https://metadata.vara-network.io/#/vara), switch to `Chain Specs` tab

3. Scan the `spec QR code` with your device to add Vara network.

After spec scanning you can select Vara Network for your account:

![add metadata](./img/polkadot-vault-acc0.png)

## Add network Metadata

To sign and broadcast your transaction, we will also need the metadata of the given network. Polkadot Vault can be easily updated with the latest blockchain metadata while staying offline.

![add metadata](./img/polkadot-vault-phone.png)

To get the latest blockchain metadata:

1. Open your Polkadot Vault and select tab `scan`

2. Again go to [Metadata Portal](https://metadata.vara-network.io/#/vara)

3. In the `Metadata` tab, scan video QR with metadata frames. Wait for `Parsing multipart data` is completed.

:::info
Scanning QR with metadata could take some time. Remember to update the Polkadot Vault to the latest version of metadata, you will need to do the scan again. We generate new QR's with each runtime upgrade of the network.
:::

When all metadata is uploaded, Polkadot Vault will be ready to work with the Vara Network.

## How to use

Polkadot Vault allows you to sign transactions using an air-gapped way. You scan a QR code with details about your transaction, then generate a code already signed on your offline device and deliver it as confirmation. Many applications support this feature.

### SubWallet

![img alt](./img/subwallet-polkadot-vault.png)

1. For instructions on how to use Polkadot Vault with SubWallet Extension, see [here] (https://docs.subwallet.app/main/extension-user-guide/account-management/attach-a-polkadot-vault-previously-parity-signer-account).

2. For instructions on how to use Polkadot Vault with SubWallet Mobile, see [here] (https://docs.subwallet.app/main/mobile-app-user-guide/account-management/attach-a-polkadot-vault-previously-parity-signer-account).

3. For visual instructions, see the video [here] (https://youtu.be/9qKf_FrwzxE?si=_hQJj9tp2sQ--rpV).


### Nova Wallet

Nova Wallet also supports Polkadot Vault. More details https://docs.novawallet.io/nova-wallet-wiki/welcome-to-nova-wallet/hardware-wallets

### Polkadot.{js}

To import your hard wallet account into Polkadot.js:

1. You should go to [Accounts](https://polkadot.js.org/apps/#/accounts) section and click the `from QR` button.

![add metadata](./img/polkadtot-via-qr.png)

2. In the Polkadot Vault app, select your account and network.

![add metadata](./img/polkadot-vault-acc.png)

3. Show your code to the camera.

Done! Now, when making transactions from this account, you will sign them with your Polkadot Vault app using QR codes.

### Polkadot.{js} extension

1. In your Polkadot.{js} extension allow QR camera access

![add metadata](./img/p-ext-1.png)

2. Click <keyboard>+</keyboard> to import new account and choose `Attach external QR-signer account` option:

![add metadata](./img/p-ext-2.png)

3. Show your account QR-code to the camera. Done!