Skip to content

Commit

Permalink
Merge pull request #3426 from dfinity/andrew/ledger-quill-docs
Browse files Browse the repository at this point in the history
Added docs on how to access neurons created with quill using the NNS …
  • Loading branch information
csepreghy authored Sep 4, 2024
2 parents f2892ed + beee717 commit 5583602
Show file tree
Hide file tree
Showing 11 changed files with 66 additions and 0 deletions.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Original file line number Diff line number Diff line change
@@ -0,0 +1,65 @@
---
keywords: [intermediate, governance, tutorial, nns]
---

import { MarkdownChipRow } from "/src/components/Chip/MarkdownChipRow";
import '/src/components/CenterImages/center.scss';

# Accessing Neurons Created with Quill using the NNS Dapp and Ledger

<MarkdownChipRow labels={["Intermediate", "Governance", "Tutorial"]} />

<iframe width="560" height="315" src="https://www.youtube.com/embed/lKbYUmqF7J4?si=jIvx5rEza7BnMchE" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>

## Overview
You may have neurons controlled by a principal ID that was created using [quill](../../../../../../docs/current/developer-docs/developer-tools/cli-tools/quill-cli-reference/quill-parent). In this case, it may be inconvenient to manage your neurons through the terminal. If you know the seed phrase of this principal ID, you can use a Ledger hardware wallet to manage your neurons through the [NNS dapp](https://nns.ic0.app/).

## How to access neurons controlled by a principal ID created with quill

To follow this process, you may want to set up a new Ledger device. If you do, skip **step 1** and **step 2**. See warning message below for more information.

- **Step 1**: Unlock your Ledger device and navigate to **Settings Manage device** > **Security** > **Reset device**

![NNS Dapp Ledger 1](../../_attachments/ledger-1.webp)

- **Step 2**: Type in your PIN to reset your Ledger device.

:::caution
**Warning**: This process will reset the private key of your Ledger device. **You will no longer have access to digital assets you hold on this device.**

While you can always regain access by resetting the device with its current seed phrase, you may want to use a new Ledger device to continue. In general, it is advised to securely store your seed phrase.
:::

- **Step 3**: After your Ledger device has been successfully reset, navigate to **Restore from Recovery phrase**.

![NNS Dapp Ledger 2](../../_attachments/ledger-2.webp)

- **Step 4**: Select the number of words in your seed phrase, and enter the seed phrase of the principal ID that controls the neurons you would like to access.

![NNS Dapp Ledger 3](../../_attachments/ledger-3.webp)

- **Step 5**: Install the **Internet Computer** app on your Ledger device.

![NNS Dapp Ledger 4](../../_attachments/ledger-4.webp)

- **Step 6**: Go to the [NNS dapp](https://nns.ic0.app/) and Sign in with **Internet Identity**.

- **Step 7**: Go to **Tokens** > **Internet Computer** > **+ Add Account** and select **New Account (Hardware Wallet)**.

![NNS Dapp Ledger 5](../../_attachments/ledger-5.webp)

- **Step 8**: While your Ledger device is connected to your computer, select your device from the popup to connect.

![NNS Dapp Ledger 6](../../_attachments/ledger-6.webp)

- **Step 9**: You can verify the principal ID and account ID, then click **Create**.

![NNS Dapp Ledger 7](../../_attachments/ledger-7.webp)

- **Step 10**: Select the ICP account you just created

- **Step 11**: Click **Show Neurons** and approve the transaction on your Ledger device

![NNS Dapp Ledger 8](../../_attachments/ledger-8.webp)

- **Step 12**: Click **Add to NNS Dapp** to add your NNS Dapp principal ID as a hotkey to the neurons. This allows you to see and manage your neurons using the NNS Dapp. For all actions outside of voting and changing following, you will need to have your Ledger device connected and approve the action.
1 change: 1 addition & 0 deletions sidebars.js
Original file line number Diff line number Diff line change
Expand Up @@ -1121,6 +1121,7 @@ const sidebars = {
"developer-docs/daos/nns/using-the-nns-dapp/nns-dapp-voting-on-proposals",
"developer-docs/daos/nns/using-the-nns-dapp/nns-dapp-following-other-neurons",
"developer-docs/daos/nns/using-the-nns-dapp/nns-dapp-advanced-neuron-operations",
"developer-docs/daos/nns/using-the-nns-dapp/nns-dapp-manage-quill-neurons",
"developer-docs/daos/nns/using-the-nns-dapp/nns-dapp-additional-features",
],
},
Expand Down

0 comments on commit 5583602

Please sign in to comment.