# Onboarding

Hinkal Wallet onboarding is designed to be simple, secure, and fully self-custodial.

You can choose between three options:

* Create a new wallet
* Import an existing wallet
* Access the legacy version (for users who had hinkal wallet before update)

### Create a New Wallet

(Welcome screen → **Create a wallet**)

1. **Set your password**\
   Create a password for your wallet. This password unlocks your wallet on this device only.\
   If you forget it, you can recover access using your recovery phrase.
2. **Review security notice**\
   Before proceeding, you’ll see an important reminder:

   * Your recovery phrase gives full access to your wallet
   * Anyone with it can control your funds

   Make sure you are in a private environment before continuing.
3. **Generate your recovery phrase**

   Hinkal generates a unique 12-word recovery phrase.

   This is the **only way** to restore your wallet.

   * Store it securely
   * Never share it
   * Never enter it anywhere except inside your wallet
4. **Save and confirm your recovery phrase**\
   After saving it, you’ll need to re-enter the phrase to confirm.

   This ensures you’ve stored it correctly.
5. **Create a username (optional)**\
   Choose a username for your wallet.

   This is used for personalization and can be changed later.
6. **Wallet ready**\
   Your wallet is now created.

   Click **Start your Privacy Journey** to continue.
7. **Unlock your wallet**\
   To access your wallet, enter your password.

   You’re now fully set up and ready to use Hinkal.

{% tabs fullWidth="true" %}
{% tab title="Step 1 - Set your password" %}

<figure><img src="/files/UjvruzIT2TgdswRLXnRJ" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Step 2 - Review security notice" %}

<figure><img src="/files/G78szvUzwcAE8mHzh0mi" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Step 3 - Generate your recovery phrase" %}

<figure><img src="/files/6Nh9R8kHFybwADZ2G85d" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Step 4 - Save and confirm your recovery phrase" %}

<figure><img src="/files/WtxDnE98K6qA2pcqhZTp" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Step 5 - Create a username" %}

<figure><img src="/files/cnxowQJT1QZvtpPjuTz6" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Step 6 - Wallet ready" %}

<figure><img src="/files/yxDvswy4XXdt7MnjJCPh" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Step 7 - Unlock your wallet" %}

<figure><img src="/files/bYrpGqMfjaGUSQG6WkFr" alt=""><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

### **Import a Wallet**

**Use this option if you already have a wallet with a recovery phrase.**\
(Welcome screen → **Import a wallet**)

1. **Set your password**\
   Create a local password for this device.
2. **Enter your existing recovery phrase**\
   Input the 12-word recovery phrase from your existing wallet.

   This restores your wallet and all associated accounts.
3. **Wallet ready**\
   Once imported, click **Start your Privacy Journey**.
4. **Access your wallet**\
   Enter your password to unlock and start using Hinkal.

{% tabs fullWidth="true" %}
{% tab title="Step 1 - Set your Password" %}

<figure><img src="/files/rkxh9VgJ94MchWv7cPFQ" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Step 2 - Enter your existing recovery phrase" %}

<figure><img src="/files/7jmpf1F7Jr0Jhm3ORLiO" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Step 3 - Wallet ready" %}

<figure><img src="/files/eUXOnKCGhrdConSVXceb" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Step 4 - Access your wallet" %}

<figure><img src="/files/fI8XvRgpYohCSeEedEvL" alt=""><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

### Legacy **Version**

Use this option if you created a Hinkal wallet **before the update**. Legacy option leads you to an old onboarding flow.\
(Welcome screen → **Legacy version**)

1. **Go to legacy flow**\
   Click **Back to Legacy version**, then **Get Started**.
2. **Import your previous Hinkal wallet**\
   Select **Import Hinkal Wallet**.
3. **Set a password**\
   Create a new password for your wallet on this device.
4. **Enter your old recovery phrase**\
   Input the recovery phrase from your previous Hinkal wallet.

   This restores your existing wallet.
5. **Finish setup**\
   After confirming, your wallet is ready.

   Click **Open Wallet**, enter your password, and continue.

{% tabs fullWidth="true" %}
{% tab title="Step 1 - Go to legacy flow" %}

<figure><img src="/files/vupluPhlORjD6tCLdrZs" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Step 2 - Select Import Hinkal Wallet" %}

<figure><img src="/files/d9WXquqJoSAFEVHL6vvY" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Step 3 - Set a password" %}

<figure><img src="/files/Wof1UVHNoEU9VyzCwTto" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Step 4 - Enter your old recovery phrase" %}

<figure><img src="/files/bQa0brlBlhQcm0RjcTZI" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Untitled" %}

<figure><img src="/files/YYqBagnIlXqcJF6oLUpm" alt=""><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

### Connecting an existing wallet (Legacy)

You can also connect an existing external wallet through the legacy flow.

This process is similar to the standard wallet connection:

* Select your wallet provider
* Approve the connection request
* Sign the message to authenticate

The interface may differ slightly, but the functionality remains the same.

### Which path should I choose?

* **Create a wallet**\
  Best for new users. Full self-custody with a new recovery phrase.
* **Import a wallet**\
  Use an existing recovery phrase to restore a wallet.
* **Legacy version**\
  Only for users who had a Hinkal wallet before the update.

### Important Notes

* Hinkal is fully self-custodial
* Your recovery phrase is the **only backup**
* Hinkal cannot recover your wallet if you lose it


---

# 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://hinkal-team.gitbook.io/hinkal/hinkal-wallet/getting-started/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.
