Difference between revisions of "Using the Wallet Generator"

From xx network wiki
Jump to navigation Jump to search
m
Tags: Mobile web edit Mobile edit
(Add link to webapp wallet generator)
 
(6 intermediate revisions by one other user not shown)
Line 1: Line 1:
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.
== Wallet webapp ==


You can generate a wallet mnemonic phrase a non-quantum secure wallet mnemonic phrase using either the {{abbr|Command Line Interface|CLI}} tool or the {{abbr|Graphical User Interface|GUI}} tool found on the [https://xx.network/wallet-gen xx Wallet Generation page]:


# 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.
You can create quantum-ready wallets for use in the xx network directly in the wallet [https://wallet.xx.network/#/accounts/generate webapp]!
# 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 [https://github.com/xx-labs/sleeve/ sleeve GitHub repository].
 
Once the page is loaded, you can turn off your internet connection and proceed with creating the wallet by following the steps shown.
 
If you still prefer to generate the wallet without using a browser, keep reading.
 
== Wallet Generator app ==
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 {{abbr|Command Line Interface|CLI}} tool or the {{abbr|Graphical User Interface|GUI}} tool found on the [https://xx.network/mainnet-wallet-gen xx Wallet Generation page]:
 
# 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. [https://xx.network/mainnet-wallet-gen [Source]]
# The CLI tool is a command line app with instructions but minimal additional context. [https://github.com/xx-labs/sleeve [Source]]


== GUI Tool ==
== GUI Tool ==


<ol style="list-style-type: decimal;">
<ol style="list-style-type: decimal;">
<li><p>First, download the GUI xx network Sleeve Wallet Generation Tool from the [https://xx.network/wallet-gen xx Wallet Generation page]. Make sure to select the correct download for your operating system and architecture.</p>
<li><p>First, download the GUI xx network Sleeve Wallet Generation Tool from the [https://xx.network/mainnet-wallet-gen xx Wallet Generation page]. Make sure to select the correct download for your operating system and architecture.</p>
</li>
</li>
<li><p>Launch the downloaded binary. Refer to the detailed instructions below for your operating system.</p>
<li><p>Launch the downloaded binary. Refer to the detailed instructions below for your operating system.</p>
Line 26: Line 36:
</li>
</li>
<li><p>A UAC (User Account Control) prompt will appear asking if you want to allow the app. Click ''Yes'' to continue.</p>
<li><p>A UAC (User Account Control) prompt will appear asking if you want to allow the app. Click ''Yes'' to continue.</p>
[[File:UAP Dialogue for ProtoNet Wallet Generator GUI.png|center|alt=UAP Dialogue for ProtoNet Wallet Generator GUI]]
[[File:UAP Dialogue for ProtoNet Wallet Generator GUI.png|center|alt=UAP Dialogue for Wallet Generator GUI]]
</li>
</li>
<li><p>Wait for the setup to finish.</p>
<li><p>Wait for the setup to finish.</p>
Line 73: Line 83:
</li>
</li>
<li><p>Use {{mono|dpkg}} (the package manager for Debian) to install the package.</p>
<li><p>Use {{mono|dpkg}} (the package manager for Debian) to install the package.</p>
{{Terminal|icon=|text=<span class="noselect">'''$''' </span>sudo dpkg -i wallet-gen_0.1.0_amd64.deb}}
{{Terminal|icon=|text=<span class="noselect">'''$''' </span>sudo dpkg -i wallet-gen_0.2.0_amd64.deb}}
</li>
</li>
<li><p>You can then launch the ''Quantum-Ready Wallet Generator'' application via the GUI or via the command line.</p>
<li><p>You can then launch the ''Quantum-Ready Wallet Generator'' application via the GUI or via the command line.</p>
Line 88: Line 98:
</li>
</li>
<li><p>Use {{mono|rpm}} (the RPM package manager) to install the package.</p>
<li><p>Use {{mono|rpm}} (the RPM package manager) to install the package.</p>
{{Terminal|icon=|text=<span class="noselect">'''$''' </span>sudo rpm -i wallet-gen-0.1.0.x86_64.rpm}}
{{Terminal|icon=|text=<span class="noselect">'''$''' </span>sudo rpm -i wallet-gen-0.2.0.x86_64.rpm}}
</li>
</li>
<li><p>You can then launch the ''Quantum-Ready Wallet Generator'' application via the GUI or via the command line.</p>
<li><p>You can then launch the ''Quantum-Ready Wallet Generator'' application via the GUI or via the command line.</p>
Line 108: Line 118:


<ol style="list-style-type: decimal;">
<ol style="list-style-type: decimal;">
<li><p>First, download the CLI xx network Sleeve Wallet Generation Tool from the [https://xx.network/wallet-gen xx Wallet Generation page]. Make sure to select the correct download for your operating system and architecture.</p>
<li><p>First, download the CLI xx network Sleeve Wallet Generation Tool from the [https://xx.network/mainnet-wallet-gen xx Wallet Generation page]. Make sure to select the correct download for your operating system and architecture.</p>
</li>
</li>
<li><p>Launch the downloaded binary. Refer to the detailed instructions below for your operating system.</p>
<li><p>Launch the downloaded binary. Refer to the detailed instructions below for your operating system.</p>
Line 173: Line 183:
|  in the generation of curve based, non quantum secure keys |
|  in the generation of curve based, non quantum secure keys |
|                                                            |
|                                                            |
|  Find out more about Sleeve at: xx.network/sleeve         |
|  Find out more about Sleeve at: github.com/xx-labs/sleeve |
|------------------------------------------------------------|
|------------------------------------------------------------|


|------------------------------------------------------------|
|------------------------------------------------------------|
| This tool will generate three outputs that MUST be stored |
|             Please select an option:                      |
|    </nowiki>{{font color|#3a96dd|1. the Sleeve wallet mnemonic phrase}}<nowiki>                   |
|                                                            |
|    </nowiki>{{font color|#13a10e|2. the regular wallet mnemonic phrase}}<nowiki>                  |
|    </nowiki>{{font color|#3a96dd|1 --> Generate a new Sleeve wallet}}<nowiki>                     |
|    </nowiki>{{font color|#881798|3. the regular wallet address}}<nowiki>                           |
|    </nowiki>{{font color|#13a10e|2 --> Recover the standard wallet mnemonic}}<nowiki>             |
|------------------------------------------------------------|
|------------------------------------------------------------|




   Press enter to continue
 
   Please type an option to continue
</nowiki><span class="blink" style="color:lime;">█</span>}}
</nowiki><span class="blink" style="color:lime;">█</span>}}
</li>
</li>
Line 194: Line 204:


== Wallet Creation and Storage Tips ==
== Wallet Creation and Storage Tips ==
There are a series of things a wallet holder can do to better secure their xx coins at this time. None of these solutions, in fact no solution, is perfectly secure in all circumstances. It is important for a wallet holder to understand their situation, their risks as well as their risk tolerance when making an informed decision about the security of their wallet.
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.
* 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.  
* 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 a variety of ways. It is never advised to store a wallet on a computer, especially an internet connected one.  
* 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.  
* Make sure that you trust any application you enter your recovery phrase into - Any application which a recover phrase is entered into has complete control of funds. Ensure any application the prease is entered into is completely trusted. If you are capable, it is recommended to example the source code and compile the application yourself.
* 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.
* Store your recovery phrase somewhere safe (safety deposit box, secure safe) Ensure there are safeguards against the recovery phrase being physically taken from you.

Latest revision as of 23:22, 5 August 2022

Wallet webapp

You can create quantum-ready wallets for use in the xx network directly in the wallet webapp!

Once the page is loaded, you can turn off your internet connection and proceed with creating the wallet by following the steps shown.

If you still prefer to generate the wallet without using a browser, keep reading.

Wallet Generator app

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.