# Onboarding

### Introduction

QSafe Wallet offers users a seamless and secure onboarding experience through a browser extension. Once installed, users are guided step-by-step through either creating a new wallet or restoring an existing one, with user-friendly interfaces and essential security checks.<br>

### Getting Started: Wallet Installation & Launch

After installing the QSafe Wallet extension and launching it, users are redirected to the **Onboarding Page**, where they are greeted with a simple interface containing two options:

1. **Create a New Wallet**
2. **Restore Existing Wallet**

<figure><img src="/files/YNDqhQPfQceHo0k01i35" alt=""><figcaption></figcaption></figure>

**(i) Creating a New Wallet**

#### Step 1: Create a Password

* The first step is to **create a strong password** for protecting the wallet.
* This password is essential for accessing the wallet locally.
* ⚠️ **Important:** This password **cannot be recovered**. Users are advised to store it securely.

<figure><img src="/files/8xFxOencH8aHwQ79VEZj" alt=""><figcaption></figcaption></figure>

#### Step 2: Confirm the Password

* Users must **re-enter the password** to confirm it was typed correctly and remembered.
* This validation ensures the user is aware of the exact password used.

<figure><img src="/files/qBn3hGPtBMZh2WLFnk7x" alt=""><figcaption></figcaption></figure>

#### Step 3: Mnemonic Phrase Generation

* Upon successful password creation, a **12-word mnemonic phrase** is generated.
* This is a **critical security component** for recovering the wallet in the future.
* Users are instructed to **save this phrase offline**, preferably in a secure, physical location.

<figure><img src="/files/5npebNcqnh1mfBXLFUAZ" alt=""><figcaption></figcaption></figure>

#### Step 4: Mnemonic Phrase Verification

* To ensure the user has **securely stored the phrase**, a short quiz is conducted.
* Example:\
  \&#xNAN;*"Which of the following is the 9th word of your secret phrase?"*\
  Options: `Supply`, `Wire`, `Local`, `Silent`
* The user must **correctly answer** to proceed.

**Once all four steps are completed successfully**, the user is granted full access to the QSafe Wallet and its features.

### (ii) Restore an Existing Wallet

If the user has previously created a wallet and wants to restore it:

#### Step 1: Choose "Restore Existing Wallet"

* On the onboarding screen, the user selects the second option to begin the recovery process.

#### Step 2: Enter Secret Recovery Phrase

* The user is redirected to a screen with a text area.
* They must enter the **12-word mnemonic phrase** from their previous wallet setup.

<figure><img src="/files/cEpOzaUmW6j5dKaTpSn7" alt=""><figcaption></figcaption></figure>

#### Step 3: Create a New Password

* After successfully entering the phrase, the user must **set a new password** for the restored wallet.
* This password is specific to the current device/browser instance.

<figure><img src="/files/Bp2i1Lcvtn8g9TKi2P67" alt=""><figcaption></figcaption></figure>

#### Step 4: Confirm the Password

* The new password is re-entered to ensure correctness and awareness.

**Upon completing these steps**, the wallet is restored successfully, and all previously associated data (accounts, balances, activity) becomes accessible again.

<figure><img src="/files/Opsdb5YaIRPH8Ex5jrej" alt=""><figcaption></figcaption></figure>

Important Notes

* The **12-word mnemonic phrase is the only way to recover the wallet**. QSafe does not store it, and it should never be shared with anyone.
* The **password only protects local access** and **cannot be recovered** if forgotten. Use secure methods to store both the password and mnemonic phrase.
* Screenshots corresponding to each step in both processes should be referenced for visual clarity (as indicated in the source text).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.qsafewallet.com/all-features/onboarding.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.