Difference between revisions of "Using the Wallet Generator"

From xx network wiki
Jump to navigation Jump to search
Tags: Mobile web edit Mobile edit
Line 39: Line 39:
[[File:Open Quantum-Ready Wallet Generator .dmg from Dock.png|center|alt=Open Quantum-Ready Wallet Generator .dmg from Dock]]
[[File:Open Quantum-Ready Wallet Generator .dmg from Dock.png|center|alt=Open Quantum-Ready Wallet Generator .dmg from Dock]]
</li>
</li>
<li><p>In the window that opens, drag the file on the left into the ''Applications'' folder on the right.</p>
<li><p>In the window that opens, drag the '' Quantum-Ready Wallet Generator'' on the left into the ''Applications'' folder on the right.</p>
[[File:Drag Quantum-Ready Wallet Generator to the Applications Folder.png|center|alt=Drag Quantum-Ready Wallet Generator to the Applications Folder]]
[[File:Drag Quantum-Ready Wallet Generator to the Applications Folder.png|center|alt=Drag Quantum-Ready Wallet Generator to the Applications Folder]]
</li>
</li>
<li><p>Open your Applications folder by double-clicking on the Applications folder icon.</p>
<li><p>Open the Applications folder by double-clicking on the ''Applications'' folder icon.</p>
[[File:MacOS Applications Folder Icon.png|90px|center|alt=MacOS Applications Folder Icon]]
[[File:MacOS Applications Folder Icon.png|90px|center|alt=MacOS Applications Folder Icon]]
</li>
</li>
Line 48: Line 48:
[[File:Context Menu Open Quantum-Ready Wallet Generator.png|866px|center|alt=Context Menu Open Quantum-Ready Wallet Generator]]
[[File:Context Menu Open Quantum-Ready Wallet Generator.png|866px|center|alt=Context Menu Open Quantum-Ready Wallet Generator]]
</li>
</li>
<li><p>A warning will appear asking if you want to open the app. Click ''Open'' again.</p>
<li><p>A warning will appear saying that the developer cannot be verified. Click the ''Cancel'' button.</p>
[[File:Open Warning for Quantum-Ready Wallet Generator App.png|515px|center|alt=Open Warning for Quantum-Ready Wallet Generator App]]
[[File:Open Warning for Quantum-Ready Wallet Generator App.png|515px|center|alt=Click cancel on Quantum-Ready Wallet Generator App develop cannot be verified warning.]]
</li>
</li>
<li><p>Next, click on the Apple icon in the top left corner of your screen in the menu bar. In the drop-down menu, select System ''Preferences…''.</p></li>
<li><p>The System Preferences window will show up. Click on ''Security & Privacy''.</p></li>
<li><p>Make sure you are in the ''General'' tab (selected at the top). Then, at the bottom, where it says ''"Quantum-Ready Wallet Generator" was blocked…'', click the ''Open Anyway'' button.</p></li>
<li><p>In the window that opens, click the ''Open'' button and the wallet generator will launch.</p></li>
</ol>
</ol>
</li>
</li>

Revision as of 21:57, 10 November 2021

The ProtoNet Wallet Generator app walks you through the process of creating a quantum-ready wallet for use in the xx ProtoNet. While you should secure the wallet you generate as you would any other cryptocurrency wallet, the currency used will not be transferred to MainNet and will have no economic value.

You can generate a wallet mnemonic phrase a non-quantum secure wallet mnemonic phrase using either the CLI tool or the GUI tool found on the xx Wallet Generation page:

  1. The GUI tool is a user-friendly app that walks you through the process with instructions and insight at each step. If you are new to cryptocurrency wallets, we recommend this choice. This will be open-sourced in the coming weeks but uses the same library as the CLI.
  2. The CLI tool is a command line app with instructions but minimal additional context. This is currently open-sourced and can be found on the xx labs sleeve GitHub repository.

GUI Tool

  1. First, download the GUI xx network Sleeve Wallet Generation Tool from the xx Wallet Generation page. Make sure to select the correct download for your operating system and architecture.

  2. Launch the downloaded binary. Refer to the detailed instructions below for your operating system.

    1. Windows Instructions.

      1. Download the .exe file for Windows.

      2. In the file browser, navigate to the folder where the application was downloaded to; this will most likely be your downloads folder.

      3. Double click on the executable to run.

      4. You may get a notice saying "Windows protected your PC" preventing you from running the binary. To get past the SmartScreen filter, click on the More info link.

        Screen capture of the Windows SmartScreen window with a red arrow pointing at the More info link.
      5. Next, click the Run anyway button and the setup will launch.

        Screen capture of the Windows SmartScreen window after the More info link was clicked now showing the Run anyway button.
      6. A UAC (User Account Control) prompt will appear asking if you want to allow the app. Click Yes to continue.

        UAP Dialogue for ProtoNet Wallet Generator GUI
      7. Wait for the setup to finish.

        Quantum-Ready Wallet Generator Setup Window
    2. macOS Instructions.

      1. Download binary for macOS. The provided binary is compiled for Intel but will work for both Intel and M1 architectures.

      2. Open the .dmg file.

        Open Quantum-Ready Wallet Generator .dmg from Dock
      3. In the window that opens, drag the Quantum-Ready Wallet Generator on the left into the Applications folder on the right.

        Drag Quantum-Ready Wallet Generator to the Applications Folder
      4. Open the Applications folder by double-clicking on the Applications folder icon.

        MacOS Applications Folder Icon
      5. Find the Quantum-Ready Wallet Generator app in the application list, right-click the app, and select Open. You cannot double-click on the app the first time it is opened. It must be opened by right-clicking and selecting Open.

        Context Menu Open Quantum-Ready Wallet Generator
      6. A warning will appear saying that the developer cannot be verified. Click the Cancel button.

        Click cancel on Quantum-Ready Wallet Generator App develop cannot be verified warning.
      7. Next, click on the Apple icon in the top left corner of your screen in the menu bar. In the drop-down menu, select System Preferences….

      8. The System Preferences window will show up. Click on Security & Privacy.

      9. Make sure you are in the General tab (selected at the top). Then, at the bottom, where it says "Quantum-Ready Wallet Generator" was blocked…, click the Open Anyway button.

      10. In the window that opens, click the Open button and the wallet generator will launch.

    3. Linux instructions for .deb Package (Ubuntu, Debian, Mint, etc.).

      1. Download the .deb file.

      2. Open the terminal.

      3. Use cd to change directories to the location of the .deb file.

        Terminal
      4. Use dpkg (the package manager for Debian) to install the package.

        Terminal
      5. You can then launch the Quantum-Ready Wallet Generator application via the GUI or via the command line.

        Terminal
    4. Linux instructions for .rpm Package (Fedora, CentOS, RHEL, etc.).

      1. Download the .rpm file.

      2. Open the terminal.

      3. Use cd to change directories to the location of the .rpm file.

        Terminal
      4. Use rpm (the RPM package manager) to install the package.

        Terminal
      5. You can then launch the Quantum-Ready Wallet Generator application via the GUI or via the command line.

        Terminal
  3. The GUI should launch; follow the rest of the onscreen prompts.

    Screen capture of the Wallet Generator GUI
  4. You should now have a quantum-secure recovery phrase, a standard recovery phrase, and a wallet address. Save these in a safe and secure place.

Make sure to save the quantum-secure recovery phrase, standard recovery phrase, and wallet address in a safe and secure place.

CLI Tool

  1. First, download the CLI xx network Sleeve Wallet Generation Tool from the xx Wallet Generation page. Make sure to select the correct download for your operating system and architecture.

  2. Launch the downloaded binary. Refer to the detailed instructions below for your operating system.

    1. Windows Instructions.

      1. Download the .exe file for Windows.

      2. In the file browser, navigate to the folder where the application was downloaded to; this will most likely be your downloads folder.

      3. Double click on the executable to run.

      4. You may get a notice saying "Windows protected your PC" preventing you from running the binary. To get past the SmartScreen filter, click on the More info link.

        Screen capture of the Windows SmartScreen window with a red arrow pointing at the More info link.
      5. Next, click the Run anyway button and it will launch.

        Screen capture of the Windows SmartScreen window after the More info link was clicked now showing the Run anyway button.
    2. macOS Instructions.

      1. Download the correct binary for your architecture (either Intel or M1 processor).

      2. Open the Terminal app.

      3. Use cd to change directories to the location of the script. It will most likely be in your Downloads folder.

        Terminal
      4. Change the permissions of the script so that it can be executed.

        Terminal
      5. Use xattr to remove the quarantine bit of the binary so that Gatekeeper does not block its execution.

        Terminal
      6. Launch the script.

        Terminal
    3. Linux instructions.

      1. Download the correct binary.

      2. Open the terminal.

      3. Use cd to change directories to the location of the script.

        Terminal
      4. Change the permissions of the script so that it can be executed.

        Terminal
      5. Launch the script.

        Terminal
  3. The tool should launch in your terminal. Press Enter to continue and follow the rest of the onscreen prompts.

    Terminal
  4. You should now have a sleeve wallet mnemonic phrase, a non-quantum secure wallet mnemonic phrase, and a wallet address. Save these in a safe and secure place.

Make sure to save the sleeve wallet mnemonic phrase, non-quantum secure wallet mnemonic phrase, and wallet address to a safe and secure place.