Using the Wallet Generator

From xx network wiki
Revision as of 16:54, 16 November 2021 by Jono (talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search
This is a team contributed page

The Wallet Generator app walks you through the process of creating a quantum-ready wallet for use in the xx network. It is extremely important that you store both mnemonic phrases in a safe, secure, and private location. Loss of these can result in an inability to access your wallet and coins.

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. [Source]
  2. The CLI tool is a command line app with instructions but minimal additional context. [Source]

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 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….

        Select System Preferences from Apple drop-down menu.
      8. The System Preferences window will show up. Click on Security & Privacy.

        Click on Security & Privacy in the System preferences window.
      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.

        Click the Open Anyway button to allow the Quantum-Ready Wallet Generator app
      10. In the window that opens, click the Open button and the wallet generator will launch.

        Click the Open button the launch the Quantum-Ready Wallet Generator.
    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.

Wallet Creation and Storage Tips

There are a series of things a wallet holder can do to secure their xx coins better. However, none of these solutions, in fact, no solution, is perfectly secure in all circumstances. Therefore, a wallet holder needs to understand their situation, risks, and risk tolerance when making an informed decision about the security of their wallet.

  • Split large balances between multiple wallets — By separating large balances between multiple wallets, a wallet holder can reduce the loss of the breach of any given wallet.
  • Never give your recovery phrase to anyone — Knowledge of the recovery phrase is the same as control of the wallet. Sharing a recovery phrase gives the holder complete access to all funds in the wallet.
  • Do not store your recovery phrase on a computer — Computers, especially internet-connected computers, can be compromised in various ways. It is never advised to store a wallet on a computer, especially an internet-connected one.
  • Ensure that you trust any application you enter your recovery phrase into — Any application that a recover phrase is entered into has complete control of funds. Ensure any application the phrase is entered into is completely trusted. If you are capable, it is recommended to example the source code and compile the application yourself.
  • Store your recovery phrase somewhere safe (safety deposit box, secure safe) — Ensure there are safeguards against the recovery phrase being physically taken from you.