Using the Wallet Generator

From xx network wiki
Revision as of 19:51, 23 July 2021 by Jono (talk | contribs) (→‎GUI Tool)
Jump to navigation Jump to search
This is a team contributed page

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 an 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 the correct binary for your architecture (either Intel or M1 processor). If you are unsure which processor your Mac has, then click on the Apple icon in the top left of the screen and click About This Mac. Look for a label that says Processor or Chip.

      2. Open the .dmg file.

        Open ProtoNet Wallet Generator dmg File
      3. In the window that opens, drag the file on the left into the Applications folder on the right.

        Drag Quantum-Ready Wallet Generator to the Applications Folder
      4. Open your 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 and right click the app and select Open. You cannot double-click on the app the first time it is opened. It must opened by right clicking and selecting Open.

        Context Menu Open Quantum-Ready Wallet Generator
      6. A warning will appear asking if you want to open the app. Click Open again.

        Open Warning for Quantum-Ready Wallet Generator App
    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 the execution of it.

        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. This is your stash account.

  5. Relaunch the tool to generate a Sleeve wallet mnemonic phrase, a non quantum secure wallet mnemonic phrase, and a wallet address for the controller account.

Make sure to save the Sleeve wallet mnemonic phrase, a non quantum secure wallet mnemonic phrase, and a wallet address for both accounts in a safe and secure place.