Skip to content

Document exporting public key with QR code #86

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

Open
wants to merge 3 commits into
base: master
Choose a base branch
from
Open
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
3 changes: 1 addition & 2 deletions _pages/setup-computer/specter-advanced.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,6 @@ Follow [these instructions](https://github.com/cryptoadvance/specter-desktop#how
More details [here](https://github.com/cryptoadvance/specter-desktop/blob/master/DEVELOPMENT.md).

#### Run Behind Tor
TODO: add link

Follow the [official instructions](https://github.com/cryptoadvance/specter-desktop/blob/master/docs/tor.md) to run Specter-Desktop over a Tor hidden service.

{% include next_steps.md next_url="/setup-wallets" next_name="Setup Hardware Wallets" %}
4 changes: 2 additions & 2 deletions _pages/setup-wallets/cobo-advanced.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,10 +23,10 @@ CertUtil: -hashfile command completed successfully.
#### Generate your own seedphrase

Using seedpicker:
https://support.cobo.com/hc/en-us/articles/360060645233-Construct-Your-Own-Recovery-Phrase
<https://support.cobo.com/hc/en-us/articles/360060645233-Construct-Your-Own-Recovery-Phrase>

Using dice:
https://support.cobo.com/hc/en-us/articles/360050478133-How-to-Use-Dice-to-Generate-Your-Recovery-Phrase
<https://support.cobo.com/hc/en-us/articles/360050478133-How-to-Use-Dice-to-Generate-Your-Recovery-Phrase>

## Not Perfect
No device is perfect and this one is no exception.
Expand Down
7 changes: 1 addition & 6 deletions _pages/setup-wallets/paper-advanced.md
Original file line number Diff line number Diff line change
Expand Up @@ -60,12 +60,7 @@ Expert users only: <https://github.com/mflaxman/human-rng-golang>
#### Improve Airgap
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Would you like me to remove this entire Improve Airgap section as it isn't really required anymore if you use a QR code instead of downloading the JSON file.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think it makes sense eventually, but for now QR isn't fully converged on. Hopefully soon!


##### Option A: Write Data to CD/DVD instead of USB Drive
DVDs are less able to execute malware on your computer.

##### Option B: Use a QR-Code Airgap
This is not currently documented.
Pull requests with clarification are welcome.
Specter-Desktop can receive this info via QR-code airgap.
DVDs are less able to execute malware on your computer
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is this intentional? Having an option A without an Option B is confusing.

I think we still want to list both options, until QR-code adoption is universal (many HW wallets with cameras for example). Some users are on desktops without webcams! Maybe we can make QR-code the preferred option?


## Improve Seed Generation

Expand Down
13 changes: 7 additions & 6 deletions _pages/setup-wallets/paper.md
Original file line number Diff line number Diff line change
Expand Up @@ -57,9 +57,8 @@ zoo zoo zoo zoo zoo zoo zoo zoo zoo zoo zoo zoo zoo zoo zoo zoo zoo zoo zoo zoo
#### Save the Output
1. Write down the whole 24 word phrase (`zoo` repeated 23 times + `buddy` as the 24th word) *offline* on paper only.
**Do not save this to any computer.**
1. Scroll down to `Export Public Key Info To Specter Desktop` and click on the `Download` button.
This will download a `json` file to your computer, containing the extended public key info.
Save the file to a DVD-R or USB drive to later share with Specter-Desktop.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think saving along the way is a good idea (even if not strictly required), so you can reverify on the display of each hardware wallet.

Maybe these steps need more detail? I've been waiting on a good 3rd hardware wallet.

1. Scroll down to `Export Public Key Info To Specter Desktop` and click on the `Show QR` button.
This will generate a QR code containing the extended public key info.
![](/assets/img/setup-paper-seedpicker-save-json.png){:class="border_image"}


Expand All @@ -72,11 +71,13 @@ See [advanced section](paper-advanced) for more info.


## Export Public Key Info to Specter-Desktop
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe we need two separate steps (one for QR and one for doing it via a file)?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

That's a good idea. I'll update it to have 2 seperate steps so users can choose their preferred way.

In the previous step, you saved your extended public key information (`seedpickerxp-foo.json`) to a DVD-R or USB drive.
In the previous step, you generated a QR code with your public key information.

1. On Specter-Desktop: Click `+ Add new device`, enter a `Name` (like `Paper Wallet`), click `Choose files` and select your file (`seedpickerxp-foo.json`), and hit `continue`.
Your file will be automatically parsed into something like this:
1. On Specter-Desktop: Click `+ Add new device`, enter a `Name` (like `Paper Wallet`), click `Scan QR code`, and scan the code from the previous step. The QR code will be automatically parsed into something like this:
![](/assets/img/setup-paper-specter-input.png){:class="border_image"}

1. Once you have verified that the key info is the same in Specter Desktop as it is in SeedPicker hit `Add device`.

1. Your public key is now added to Specter-Desktop:
![](/assets/img/setup-paper-display-pubkey.png){:class="border_image"}

Expand Down
Binary file modified assets/img/setup-paper-specter-input.png
100644 → 100755
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.