System Requirements

The Nexus Wallet can be accessed from any Mac, Windows or Linux computer simply by downloading and installing the desktop application. The minimum system requirements are as follows:

• Mac OS X Yosemite 10.10 or later
• Windows 7 or later
• Linux 64 Bit
• 512MB of RAM (1 GB Recommended)
• 7GB of disk space

Download

Download the Nexus Wallet specific to your type of device.

Click on the downward pointing arrow, and then double click on the Nexus Wallet icon.

Install

Follow the instructions on the pop up box to install.

Mac -> Drag the Nexus logo into the Application file.

If you see a dialog indicating that the developer cannot be verified, you will need to click the Open Anyway button.

Go to your applications folder and double click on the Nexus Wallet logo.

Click Open

Windows -> In Windows Explorer, find the wallet installation package you downloaded, and double-click on it. If running Windows 10 and receiving a Windows Defender screen indicating that the file should not be run, click on More Actions, then Run Anyway. Acknowledge the license agreement by clicking the “I Agree” button. Click the “Next”, “Install”, and “Finish” buttons on their respective screens.

Linux -> View the following video for details instructions on how to install the Nexus wallet on a Linux system:

Terms and Conditions

The Nexus Wallet terms are under an MIT/X11 licence. They constitute a legally binding agreement and govern the use of the Nexus Wallet. These terms and conditions must be accepted prior to use:

The MIT License (MIT)

Copyright 2019 Nexus

Permission is hereby granted, free of charge, to any person

obtaining a copy of this software and associated documentation files

(the "Software"), to deal in the Software without restriction,

including without limitation the rights to use, copy, modify, merge,

publish, distribute, sublicense, and/or sell copies of the Software,

and to permit persons to whom the Software is furnished to do so,

subject to the following conditions:

The above copyright notice and this permission notice shall be

included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,

EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF

MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND

NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT

HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,

WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,

OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER

DEALINGS IN THE SOFTWARE.

IMPROPER USE OF THIS SOFTWARE COULD LEAD TO PERMANENT LOSS OF COIN.

Bootstrap and Synchronize

Before the Wallet can be used, it needs to be synchronized with the Nexus Blockchain.

To download the Bootstrap independently from the wallet, please click here.

There are two ways in which the Wallet can be synchronized:

1. Letting the Wallet catch up with blocks on its own by just leaving the Wallet open: approx 20 - 240 minutes depending on your internet connection and network traffic.
2. ‘Bootstrapping’ the Wallet (downloading the recent database): approx 1 hour depending on your internet connection. To download the recent database please follow these instructions:

Click the top banner option ‘File’, and click on ‘Download Recent Database’.

Click, ‘Yes, let’s bootstrap it’. This will automatically download the database.

Please leave the Wallet open while bootstrapping. Selecting the ‘Abort’ option will completely stop any progress which has been made, and is not therefore advised.

If the bootstrapping pop up is minimised (by clicking off the pop up), you will be able to see what % of the database has been downloaded displayed in the left hand top corner.

When downloading the database is complete, you will see the ‘Decompressing’ box in the left hand top corner.

When Decompressing is complete, you will see the ‘Rescanning Wallet’ box in the left hand top corner.

When Rescanning is complete, the below box will pop up:

Your Wallet will then start to synchronize the last one or two percent of the Nexus Blockchain. You can check this by hovering over the first icon in the right hand corner of the Wallet:

Without a fully synchronised Wallet, incoming transactions will not show up, balances will be missing, and you will be unable to send NXS. The Wallet can be thought of as a window to view the blockchain - if your Wallet is behind, and not in sync, it will not display the true status of your Wallet on the blockchain.

When your Wallet has fully synchronized you will see a blue tick in the right hand corner of the Wallet. It is now ready to use.

It is also important to remember that if you restart your core (when enabling Staking for example) or close your Wallet or if your device loses internet connection for even a minute, then you are likely to see that 'Synchronising 99%' in the top right icon menu again. Just wait for your device to synchronize. You DO NOT need to re-download the database again (the database is only for when you initially install your Wallet, or if your Wallet has been closed for a considerable period of time, a year for example).

If you open your Wallet and on all pages it says 'Loading/syncing, please wait. If you are waiting for more than 5 minutes, we recommend restarting the Wallet. If that does not solve the problem, then please restart your device.

For more information, please see the video below from The Digital Future.

Wallet Functions

Your wallet contains lots of gadgets to play with. Refer to this section if you would like to get more familiar with the core functionality.

Create New User

Before creating a new user account, your Wallet must be fully synchronized with the Nexus Blockchain. See Step 4 - Bootstrap and Synchronize if this still needs to be completed.

To create your user account, simply choose a username, password, and PIN number.

Your password must be at least 8 characters, and the PIN a minimum of 4 digits.

When you submit your create new user request, your Wallet must complete a small proof of work that may take up to 30 seconds. Then, it will create your Signature Chain and submit it for processing. You cannot log in with your new user account until after this processing is complete and your Signature Chain is added to the Nexus Blockchain. This may happen with the next new block added, or it may take more than one block.

Typically, it should take less than 5 minutes, after which you can log into your Wallet and access your new user account.

Recommended Security

PLEASE DO NOT USE COMMON WORDS FOR YOUR PASSWORD, THIS WILL LEAVE YOU VULNERABLE TO DICTIONARY ATTACKS THAT COULD DRASTICALLY DECREASE THIS RESISTANCE.

We therefore recommend that you use a secure random number generator to create your password:

$ openssl rand -base64 8

xrMBADJZv48=

The above password generator will provide very high account security: offline password cracking will take 50 billion years to break the password/pin combination.

Security Considerations

The security of your account is very important. This section will compare the security of your account (based on SigChain technology) in comparison to the old legacy UTXO architecture.

Sect571r1 (legacy private keys) are generated in 1.56ms, whereas to generate one key in a SigChain takes 500ms, being 319x more difficult to break at equivalent password entropy.

The current resistance is 7.7291×10¹⁷¹ iterations to iterate and guess all private keys, with it taking 1.56ms per key, the time to mine all keys would be 1.2057×10¹⁶⁹ seconds.

The following command can be issued if you have openssl installed:

$ openssl rand -base64 32

This will generate a long string such as:

F/DRfiUbRvtZmZi+BQgUouzHTmckhv0oJdNaNpZvA7k=

This uses 32 characters, in base64, making brute force resistance 64^32 or 6.277101735×10⁵⁷ which would become around 3.138550868×10⁵⁷ seconds to break this password if your PIN was known.

This number is multiplied by 10 for every number you add to your PIN. A six digit numeric PIN, would increase resistance to 6.277101735×10⁶³ seconds.

If you want an even higher security standard, we recommend using your PIN as a second password (like 2 private keys).

$ openssl rand -base64 64

VPVaqjNxQgJucekY4+kBYyJgkF/0g64R4SYc9GYqsC0ntYLSisQbs+hHZB2+AKaD

i0yQCBF9U32WKCozEhuAeA==

$ openssl rand -base64 64

dCStGOhTbTqtSp1UQ1j34SS9l3vBPtA1aSocXMpheRof9a5UFPa47Tv5UjUCydO0

hf4Wj8gYMVRIuae5MKbojg==

This will give security properties of 7.762590462×10²³⁰ seconds to break into a SigChain. Which, if you don’t know, is a lot. 2^123 is the maximum amount of iterations possible with all the known energy in the universe, so this many seconds is well beyond resistant to attack.

Note: These iterations are based on the assumption that an attacker already knows your username, if they do not, this complexity only increases exponentially.

The above figure describes a resistance that would take an attacker 2.461501288×10²²³ years to break.

YOU ARE SOLELY RESPONSIBLE FOR KEEPING YOUR ACCOUNT SECURE

Create Account Recovery Phrase

WE STRONGLY RECOMMEND THAT EVERY USER ACCOUNT HAS A RECOVERY PHRASE ENABLED.

The recovery system is designed to protect accounts in the case that credentials are lost or stolen. Think of it like a backup, to ensure that you don’t lose access to your NXS.

Video

Check out the video below from The Digital Future!

Step 1: Open Recovery Dialogue

Click the user icon in the top right hand corner of the Wallet, and select 'Set recovery phrase'.

Step 2: Enter Login Credentials

PLEASE NOTE: YOUR PASSWORD AND PIN ARE REQUIRED WHEN SETTING UP A RECOVERY PHRASE

You will be required to submit your current password and PIN. Enter your credentials as you do when you are logging into your Wallet.

Step 3: Generate Recovery Phrase

Click the link titled 'Generate a recovery phrase'. You can select either a 10, 20 or 100 words for your recovery phrase. We recommend using at least 20 words for better security.

BEFORE PROCEEDING, ENSURE THAT YOU HAVE WRITTEN DOWN YOUR RECOVERY PHRASE. WE RECOMMEND WRITING IT ON PHYSICAL MATERIAL, SUCH AS PAPER, TO ENSURE IT IS SAFELY STORED OFFLINE. WE RECOMMEND MAKING MORE THAN ONE COPY OF YOUR RECOVERY PHRASE.

Step 4: Submit Recovery Phrase

Click the button labeled 'Set recovery phrase' to generate your recovery phrase. THIS PROCESS CAN TAKE UP TO 30 SECONDS TO COMPLETE. DO NOT CLOSE YOUR WALLET UNTIL THIS COMPLETES.

Once your phrase has been setup, you will see a confirmation prompt:

To confirm that it was set up properly, you can go to your transaction module, to check the most recent transaction.

This shows the contract that updated your recovery phrase, which uses the primitive OP::WRITE.

Forgot Password?

In order to change your password with your recovery phrase, you will need to click the link 'Forgot Password' at the bottom of the login page.

A dialogue box will open to submit your username, recovery phrase, new password and PIN.

You will then gain access to your account again! If you are extra paranoid, you can test recovering your account after you set it up (while using the same password) to make sure that everything is working as it should.

The recovery system works by using a special next hash, called the 'recovery hash' that allows the user to reset their password and PIN without needing account credentials.

As always, stay safe, be vigilant, and PLEASE set up your recovery phrase!

Receive NXS or a Token

To receive NXS from another sender or an exchange such as Binance or Bittrex, or to receive a Token, go to the User module, and please follow the below instructions:

1. Go to the Account page.
2. Choose the recipient account
3. Select the Copy to clipboard icon
4. Send the copied address to the sender, or paste the address into your exchange Wallet.

Send NXS or a Token

To send NXS or a Token to another address, or to move NXS between your personal accounts, go to the Send module, and please follow the below instructions:

1. Send From: Select the account that you wish to send from.
2. Send To: Select one of your personal accounts, or contacts saved in your address book, or copy and paste a new payee address.
3. Amount: Enter the NXS or Token quantity you would like to send.
4. Reference Number: Add an optional reference, invoice or order number.

Create a Token

To create a new Token, go to the User module, and please follow the below instructions:

1. Click this button to create a new token.

   

2. Choose a Token Name.
3. Choose the total number of Tokens to be created.
4. Choose the amount of significant digits the Token will have.
5. At the top of the box, the fee will be displayed in NXS for creating your supply of tokens.
6. Create Token
7. Pay Fees

Create an Account

You can create as many accounts as you wish within your main user account, for the use of NXS or any other Token issued on the Nexus blockchain. Accounts are free to create, however if you choose to give your account a name (so that you can give out an easy readable address, rather than a hexadecimal address), then a fee of 1 NXS is applied.

To create a new Named account, please follow these steps:

1. Go to the User module
2. Accounts tab
3. Create new account

A new page will open up

1. Choose an Account Name
2. Choose whether the account is for NXS or for a Token
3. Create Account

What is Staking?

Staking is an energy efficient form of mining that provides security to the Nexus network. You are not required to Stake. However, if you choose to Stake, you will be provided with a return for doing so. In order to Stake, your Wallet MUST be left open and running with an internet connection 24/7. For an introduction to Staking, please read the following web page Staking.

Video

Check out the video below from The Digital Future!

Stake Settings

Once you have created a Username, Password and PIN, the Wallet will automatically enable Staking. You can check this in the Settings module, as seen below.

When this setting is enabled (the default), your Wallet is enabled for Staking and will stake the NXS in your Trust Account whenever you log in. You must also have ‘ Staking Enabled’ in order for your Wallet to receive stake rewards. This is to prevent users from unintentionally Staking coins.

Decide How Much to Stake

When you stake your NXS, you commit a portion of your balance to be used for Proof of Stake. As long as it remains committed to stake, this NXS is generally unavailable for other uses.

How much you choose to commit to Staking is up to you. Although your committed stake amount is not locked, any request to change it requires that you mine a Proof of Stake block to implement the change. Doing so may take some time, especially for smaller balances that find blocks infrequently. Therefore, you may wish to keep some NXS in your Default Account (like a Current Account), if you require access to NXS.

Begin Staking

When you first create a new user login, the system will automatically create two accounts for you: Default and Trust. The Trust Account is used for Staking. At this point, though, the account is new and you have not committed any amount of NXS for Staking. Thus, the first step to begin Staking is to commit the initial amount you choose to stake. This is known as stake Genesis.

All you have to do to begin Staking for Genesis is to send NXS to your Trust Account, either by transferring from another account such as your Default Account or by sending it directly from any other source. After you have NXS in your Trust Account, there is a 72 hour hold before your Wallet begins to stake for Genesis. When the hold is complete, your Wallet automatically begins attempting to mine its first Proof of Stake block as long as it remains running. While Staking for Genesis, none of the NXS in your Trust Account is committed to stake. You can freely add or remove balance by simply sending it. However, if you change the Trust Account balance before it mines the initial stake Genesis, the 72 hour hold period starts over, so it works best if you decide up front how much you want to commit to stake and allow it to remain unchanged until it mines that first Proof of Stake block.

When it finds the first stake block, your Wallet moves your balance to a special Staking balance that only appears in your Trust Account and not in other accounts. This commits that balance for Staking. After the initial move, you must create a specific request to add or remove any NXS from the committed stake amount.

To do this, go to the User module, and click on Accounts on the left side to see the balance of your Trust Account.

Then click on Staking on the left side of the User module, and you can see your current Staking metrics.

Note that there is currently 0 NXS for the Stake amount, and the Unstaked amount is 10,000NXS. This is because this Trust Account is new and has not completed Staking genesis, yet. At this point, there is a 72 hour period before the account will start Staking. As long as you don’t add/remove any NXS from the Trust Account, it will begin Staking automatically at the end of this 72 hour period.

Remember that your Wallet has to be left open and logged into. Also, note that the time it takes to mine your first stake block varies based on the current level of Staking difficulty on the network. However, the size of your balance affects the time it will take.

When your Wallet mines its first Proof of Stake block, it will move your balance from ‘Unstaked amount’ to ‘Stake amount’. The corresponding stake reward for finding the block will appear in your transaction history (see Transaction module) as a Genesis transaction.

The stake reward is paid to your trust account, and will show as a balance in the ‘Unstaked amount’. This balance is currently unstaked.

Here is an image of the same Trust Account after it has mined its first Proof of Stake block.

Note that the ‘Unstaked amount’ has moved to ‘Stake amount’. This will only happen when your Wallet mines your Proof of Stake genesis. Also note that the stake reward was paid to the ‘Unstaked amount’. This balance is spendable (you can choose to send the NXS to another account, such as your Default Account, without affecting your Trust Score), or you can later choose to add the NXS to your Stake amount, which will be discussed below.

Build Trust

After your Wallet has mined Stake Genesis once, it never needs to do so again. From that point forward, whenever the Wallet mines a Proof of Stake block, it will generate a Stake Reward that will appear in your Transaction History as a Trust transaction.

As long as your Wallet is contributing to the network by mining at least one Proof of Stake block every 72 hours, it will accumulate Trust, which increases both the Trust Weight and the Stake Rate associated with your Staking. The Stake Rate can reach a maximum of 3.0% with a full year of accumulated Trust.

After Genesis, Nexus Proof of Stake will only use the ‘Stake amount’ for Staking. The ‘Unstaked amount’ in your Trust Account and the balances of all other accounts will not be staked, and can be withdrawn from the trust account without negatively impacting your Trust score.

Changing Stake Amount

The NXS in the Stake Amount of your Trust Account is committed for Staking and is used towards mining stake blocks. The amount of your Stake affects your Stake Rewards. Although it is committed to Staking, it is possible to change the amount. To do so, use the ‘Adjust stake amount’ button on the Staking view of your User module.

This button will open a dialog where you can select how much you wish to stake. Note that you enter (or set via the slider) the total amount that you want to commit to Staking, not how much to add to or remove from the current amount. This is determined automatically.

The Adjust stake dialog will also display a message similar to this:

Note: This change will not take effect immediately, but will stay pending until you get the next Trust transaction. The pending change will be recorded locally in the device you are using, therefore if you switch to another machine for Staking, the change will not take effect.

As noted earlier and also by this message, your stake change is not implemented until your Wallet mines its next stake block. In other words, you cannot change your committed Stake Amount at will. You have to mine a block to do so.

After you create a stake change request, your Staking view will show the pending change.

• You can revise this anytime before the Wallet mines its next stake block.
• Setting the Stake Amount back to its current value will cancel the change entirely.

Things to know about adding stake:

1. To add NXS to your Stake amount, you must first send it to your Trust Account where it will display as Unstaked Amount.
2. You cannot add more NXS to your Stake amount than your current Unstaked Amount.
3. Your Stake Rewards accumulate as Unstaked Amount. You can use the ‘Adjust Stake amount’ button to add the NXS back into stake if you wish. Otherwise, you can send the NXS elsewhere.
4. When you create a request to increase stake, the increase is included immediately in attempts to mine a stake block. This can help the Wallet find your next block faster.

Things to know about removing stake:

• When you remove stake, there is an associated cost. You can think of your current level of Trust as spread across the NXS in your committed stake. Therefore, if you remove a portion of that committed stake, it also reduces your Trust by an equivalent amount. For example, if you remove 10% of your committed stake, it costs 10% of your accumulated Trust.
• The purpose for having a Trust cost to remove stake is to reward those who consistently stake long term and do not frequently reduce their committed Stake amount.
• As stated before, if you require frequent access to a portion of your NXS, consider keeping it in another account (such as your Default Account) and not committing it to stake.
• The Trust cost for removing stake is not processed until your stake change request is implemented by mining a Proof of Stake block. If you change your mind, you can update the request anytime before then.
• Using the ‘Adjust stake amount’ button to set committed stake to zero will remove all stake and reset your Trust.
• Stake that is removed from ‘Stake amount’ is moved to the ‘Unstaked amount’ in your Trust account. From there, you can send it to wherever you would like to.

Trust Decay

To continue to grow your level of Trust and Stake Rate, your Wallet must mine a new Proof of Stake block every 72 hours or less. After 72 hours, your current level of Trust begins to decay. Your Trust decays at a rate of 3:1 (three times faster than you earn it). Thus, 3 weeks of Trust will decay fully in one week, and one year of Trust will decay fully in 4 months. If your Trust has decayed fully, the Wallet will display a minimum Trust Weight of 1.11% and the minimum stake rate of 0.5%. These values will remain at this level until your Wallet mines a new stake block. As soon as your Wallet mines a new Proof of Stake block, your level of trust and Stake Rate will begin growing again, and continue growing as long as it meets the 72 hour requirement going forward.

To check whether your Wallet is Staking, hover the cursor over the Nexus logo icon in the top right hand corner:

Core Modules

At the bottom of the Wallet are the core modules or pages of the Wallet. These are comparable to the default applications of a smartphone - they cannot be removed:

1. Overview
2. User
3. Send
4. Transactions
5. Address book
6. Settings
7. Console

User Module

The User module displays the signature chain’s (SigChain) username, and user ID, which is the address hash of the SigChain.

• Accounts: Displays the accounts belonging to this SigChain.
• Details: These links associated with each account display the details of the account, shown in the screenshot below. The screenshot shows an account named trust, one of the two default accounts created when a SigChain is created. The other default account is named default. The trust account is for staking NXS. Please refer to the Begin Staking section to learn about staking and adjusting the amount of NXS staked, which is done from this screen.



• History: These links display the transaction history for the associated account.

To create a new account on this SigChain for NXS or a token on the Nexus blockchain, click the Create new account button at the top of the Accounts tab of the User screen.

• Staking: Displays this SigChain’s staking metrics.
• Stake amount: Displays the amount of NXS in this SigChain’s trust account that has been assigned to stake. Stake Rate, Trust Weight, Block Weight, and Stake Weight are all explained in the Overview module section.
• Unstaked Amount: Displays the amount of NXS in this SigChain’s trust account that is unassigned and not staking. This is where stake rewards for this SigChain will appear.



• Adjust stake amount: Click to change the amount of NXS assigned to stake. When adjusting the staking amount, note that the change will not take effect until the wallet mines its next block. Please refer to the Begin Staking section.



• Tokens: Please refer to the technical guide for a detailed discussion of what tokens are and how they are created.
• Use the below button to search for a token.





• Names and Namespaces: Please refer to the technical guide for detailed coverage of the process of creating names and namespaces.
• Assets: Please refer to the technical guide for detailed coverage of the process of creating assets, otherwise known as NFTs.

Send NXS or a Token

To send NXS or a token to another wallet, or to move NXS between accounts on a single signature chain (SigChain), use the Send module, as described below:

• Send From: Specify the source account on the currently logged in SigChain from which the NXS or tokens will be deducted (e.g, debited). To send a token, specify a source account on the current SigChain that is associated with that token.
• Send To: Specify the receiving account. This could be an account on the currently logged in SigChain, a contact saved in the wallet’s address book, or a wallet address pasted from the clipboard.
• Amount: Specify the amount of NXS or token to be sent.
• Reference Number: Optionally, specify a reference, invoice, or order number.

Transactions Module

The Transactions module displays all of the transactions on the currently logged in signature chain (SigChain).

Transactions can be filtered by any of the following criteria:

• Address: Specify an address on the SigChain previously used to send or receive NXS or tokens.
• Name: Specify “NXS” or the name of a token which was previously involved in transactions on this SigChain.
• Time Span: Using one of the time periods in the image below, specify the time period of transactions to filter.



• Operation: Using one of the operation names in the image below, specify the operation of transactions to filter.



• Write: Used to write raw data to a register.
• Append: Additional data applied to an append-only register.
• Create: Used create new object registers (e.g. accounts, assets, tokens, names).
• Transfer: Transfer ownership of a register (e.g. asset) to another signature chain.
• Claim: Claim ownership of a register that has been transferred to you.
• Coinbase: Miner reward transactions.
• Trust: Stake reward transactions.
• Genesis: The first stake transaction initializing the staking process.
• Debit: NXS/tokens sent from an account.
• Credit: NXS/tokens received to an account.
• Migrate: One-time migration of legacy trust keys to tritium staking.
• Fee: Associated costs for transaction.
• Legacy: Transactions made from or received to a legacy address.

Click on any transaction to see more details, such as the account addresses, transaction ID, hash, number of confirmations, token name, and amount of the transaction.

Address Book

Here you can save your addresses by Contact name, by clicking on the ‘New Contact’ button, which will open up a dialog shown in the image below. Addresses saved to your Address Book will appear in the ‘Send To’ section of the Send module.

At the top of the page the first icon will also open up the above dialog to add a new contact.

The second icon allows you to export your contacts in a .csv file.

There is also a search function to search for a contact in your address book.

Settings

There are 4 pages within settings: Application, Core, Style, Modules.

Application

Language

Select your language of choice. The default language is English.

Minimize on close

With this enabled, even though the Wallet disappears, it is still open in the background. To re-open your Nexus Wallet do the following:

Mac: Click on the Nexus logo in the top right hand corner, and then click ‘Show Nexus Wallet’

Windows: Double click on the Nexus logo in the bottom right hand corner menu.

With this enabled, your Wallet (node) will still be online; this is therefore advisable. If your Wallet application is closed fully (Minimize on Close setting Disabled), then you will not be in sync with the Nexus Blockchain when you next open the application, and will therefore need to catch up to the current block.

Auto update

Rather than having to manually download a new Wallet each time a new update is released, which is a common necessity with many cryptocurrency Wallets, the Nexus Wallet notifies you of an update to be accepted, comparable to regular computer software updates.

Nexus strongly recommend that this setting remains enabled. This setting enabled will automatically check for new versions and notify you if a new version is available. If automatic updates are not enabled, you will be required to manually download the new Wallet version either from github.com/Nexusoft/NexusInterface or our website.

Any Wallet updates will show in a pop up box. These updates must be installed as soon as possible. Not having your Wallet on the newest version update will put your coins at risk, and could mean you are no longer synchronised with the Nexus Blockchain.

Please ensure you update your Wallet as soon as you are notified of an update.

Send anonymous usage data

Send anonymous data usage to allow the Nexus developers to improve the Wallet.

Base Currency

The option selected will be the currency in which the Balance, Market Price, Market Cap & 24hr is displayed in. The default currency is USD.

Minimum Confirmations

Minimum amount of confirmations before a block is accepted. The minimum number of confirmations is 1, but you can customize how many you require to wait before your Wallet sees the transaction as valid. 3 to 6 confirmations are recommended to maintain high levels of security.

Backup Directory

This is where your Nexus Wallet Backups are stored. When you click ‘Backup Wallet’, you are prompted with a dialogue box that allows you to select a custom directory other than the default ‘Nexus Backups’ directory.

Developer Mode

Development mode enables advanced features to aid in development. After enabling, the Wallet must be closed and reopened to enable those features

Core

Enable Mining

When mining is enabled, your Wallet will run a special server called the ‘Mining LLP’, which will allow you to connect an external miner to your Wallet for producing blocks on the Prime or Hash channels.

Enable Staking

When Staking is enabled (the default), your Wallet is enabled for Staking and will stake your Trust Account whenever you log in. You must also have ‘Staking Enabled’ in order for your Wallet to receive Trust payments. This is to prevent people from unintentionally Staking coins.

Clear Peer Connections

If xxxxxxxxxxxx, you can clear all stored peer connections and restart the Wallet.

Verbose Level

Verbose level for logs shows more under the hood data on the network. We recommend that you run verbose level 0 if you don’t need to see a lot of logging information. If you experience Wallet troubles though, more debug data is important for the developers to use to find bugs and push new releases. Use this setting at your own discretion.

Testnet Iteration

xxxx

Avatar mode

xxxxx

Manual Core mode

Xxxxx Use this option to connect another node to your code node by xxxx

Style

Render Globe

Turn the globe on or off.

Overview Display

Customize the Wallet Display. The options are:

Standard: The Wallet comes with the globe.

Miner: Displays Mining metrics, such as Prime, Hash and Stake difficulty.

Hidden Balance: Hide your NXS, USD, and incoming balances.

None: Display only the modules and twinkling stars.

Nexus Address Format

Format your NXS addresses to your liking. Note, the format (e.g. the 9 spaces in the Segmented style) is NOT copied over when copying an address. This is just for visual preference only. The options are:

Segmented

Truncate middle

Raw

Theme

There are two default themes Dark and Light.

Background

We provide two default default backgrounds Twinkling stars and Cosmic Light. You can also upload a custom wallpaper that you have saved on your device.

Color scheme

Change the colors to customize your own theme. Upon changing a color in one of the default themes you will see that your ‘Theme’ changes from either Dark or Light to ‘Custom theme’. If you were to then revert back from Custom theme to Dark theme for example, and then back to ‘Custom theme’, you will find that your custom theme has been saved.

Import Custom Theme: A variety of custom themes created by the Nexus community can be imported into the Wallet. The below link holds a repository of community made themes. The background can be imported from your local machine, or enter a URL and the Wallet will download the background for you. Acceptable formats are PNG/JPEG/BMP/TIFF/GIF.

Theme Repository

Export Custom Theme:

Themes are Json files that are read by the system and apply changes to the interface. When you export a theme, you will be prompted to save the json file to your computer. Below is a link to the theme guide which describes how to develop themes. If you would like to, please request that your theme is included in the official repository for it to be shared with the community.

Theme Guide

Modules

Security is very important, and therefore modules are sandboxed to prevent any misuse.

To import a module, simply drag the file into the center of this page.

Module app icons will appear in the bottom menu to the right of the Console icon.

Documentation on how to write modules : https://nexusoft.github.io/nw-modules-documentation/

We recommend using one of these links as a starting point:

React-Redux Example: https://github.com/Nexusoft/react_redux_module_example

React Example: https://github.com/Nexusoft/simple_react_module_example

HTML Example: https://github.com/Nexusoft/minimal_module_example

Console

The console area of the Wallet is the most ‘technical’ part. We’d recommend only using this if you feel comfortable with CLI (Command Line Interface).

Within the Console, a variety of commands can be made that send instructions to the daemon. This is very useful for debugging your Wallet, and will be used to develop more functionality as developers extrapolate new modules from the available data on our blockchain:

Entering the text ‘Help’ into the console and then pressing Execute will provide a complete list of all the console commands as below:

addmultisigaddress <'["key","key"]'> [account] - Add a required-to-sign multisignature address to the wallet each key is a nexus address or hex-encoded public key. If [account] is specified, assign address to [account].

backupwallet - Safely copies wallet.dat to destination, which can be a directory or a path with filename.

checkwallet - Check wallet for integrity.

dumpprivkey - Reveals the private key corresponding to .

echo [param]...[param] - Test function that echo's back the parameters supplied in the call.

encryptwallet - Encrypts the Wallet with .

getaccount - Returns the account associated with the given address.

getaccountaddress - Returns the current Nexus address for receiving payments to this account.

getaddressesbyaccount - Returns the list of addresses for the given account.

getbalance [account] [minconf=1] - If [account] is not specified, returns the server's total available balance. If [account] is specified, returns the balance in the account.

getblock [txinfo] - txinfo optional to print more detailed tx info. Returns details of a block with given block-hash.

getblockcount - Returns the number of blocks in the longest block chain.

getblockhash - Returns hash of block in best-block-chain at .

getblocknumber - Deprecated. Use getblockcount.

getconnectioncount - Returns the number of connections to other nodes.

getdifficulty - Returns difficulty as a multiple of the minimum difficulty.

getinfo - Returns an object containing various state info.

getmininginfo - Returns an object containing mining-related information.

getmoneysupply - Returns the total supply of Nexus produced by miners, holdings, developers, and ambassadors. Default timestamp is the current Unified timestamp. The timestamp is recorded as a UNIX timestamp

getnetworkhashps - Get network hashrate for the hashing channel.

getnetworkpps - Get network prime searched per second.

getnetworktrustkeys - List all the Trust Keys on the Network

getnewaddress [account] - Returns a new Nexus address for receiving payments. If [account] is specified (recommended), it is added to the address book so payments received with the address will be credited to [account].

getpeerinfo - Returns data about each connected network node.

getrawtransaction - Returns a std::string that is serialized, hex-encoded data for .

getreceivedbyaccount [minconf=1] - Returns the total amount received by addresses with in transactions with at least [minconf] confirmations.

getreceivedbyaddress [minconf=1] - Returns the total amount received by in transactions with at least [minconf] confirmations.

getsupplyrates - Returns an object containing current Nexus production rates in set time intervals. Time Frequency is in base 13 month, 28 day totalling 364 days. This is to prevent error from Gregorian Figures.

gettransaction - Get detailed information about

help [command] - List commands, or get help for a command.

importprivkey [label] - Adds a private key (as returned by dumpprivkey) to your Wallet.

isorphan - Returns whether a block is an orphan or not

> keypoolrefill - Fills the keypool, requires Wallet passphrase to be set.

> listaccounts - Returns object that has account names as keys, account balances as values.

> listaddresses [max=100] - Returns list of addresses

> listreceivedbyaccount [minconf=1] [includeempty=false] - [minconf] is the minimum number of confirmations before payments are included. [includeempty] whether to include accounts that haven't received any payments.

- Returns an array of objects containing:

"account" : the account of the receiving addresses

"amount" : total amount received by addresses with this account

"confirmations" : number of confirmations of the most recent transaction included

> listreceivedbyaddress [minconf=1] [includeempty=false] - [minconf] is the minimum number of confirmations before payments are included. [includeempty] whether to include addresses that haven't received any payments.

- Returns an array of objects containing:

"address" : receiving address

"account" : the account of the receiving address

"amount" : total amount received by the address

"confirmations" : number of confirmations of the most recent transaction included

> listsinceblock [blockhash] [target-confirmations] - Get all transactions in blocks since block [blockhash], or all transactions if omitted

> listtransactions [account] [count=10] [from=0] - Returns up to [count] most recent transactions skipping the first [from] transactions for account [account].

> listtrustkeys - List all the Trust Keys this Node owns.

> listunspent [minconf=1] [maxconf=9999999] ["address",...] - Returns array of unspent transaction outputswith between minconf and maxconf (inclusive) confirmations. Optionally filtered to only include txouts paid to specified addresses.

- Results are an array of objects, each of which has:{txid, vout, scriptPubKey, amount, confirmations}

> makekeypair [prefix] - Make a public/private key pair. [prefix] is optional preferred prefix for the public key.

> move [minconf=1] [comment] - Move from one account in your Wallet to another.

> repairwallet - Repair wallet if checkwallet reports any problem.

> rescan - Rescans the database for relevant wallet transactions.

> reset - Restart all node connections

> sendfrom [minconf=1] [comment] [comment-to] - is a real and is rounded to the nearest 0.000001 requires wallet passphrase to be set with walletpassphrase first

> sendmany {address:amount,...} [minconf=1] [comment] - amounts are double-precision floating point numbers requires wallet passphrase to be set with walletpassphrase first

> sendrawtransaction [checkinputs=0] - Submits raw transaction (serialized, hex-encoded) to local node and network. If checkinputs is non-zero, checks the validity of the inputs of the transaction before sending it.

> sendtoaddress [comment] [comment-to] - is a real and is rounded to the nearest 0.000001 requires wallet passphrase to be set with walletpassphrase first

> setaccount - Sets the account associated with the given address.

> signmessage - Sign a message with the private key of an address

> stop - Stop Nexus server.

> unspentbalance ["address",...] - Returns the total amount of unspent Nexus for given address. This is a more accurate command than Get Balance.

> validateaddress - Return information about .

> verifymessage - Verify a signed message

> walletlock - Removes the wallet encryption key from memory, locking the wallet. After calling this method, you will need to call walletpassphrase again before being able to call any methods which require the wallet to be unlocked.

> walletpassphrase [timeout] [mintonly] - Stores the wallet decryption key in memory for [timeout] seconds. mintonly is optional true/false allowing only block minting. timeout is ignored if mintonly is true / 1

> walletpassphrasechange - Changes the wallet passphrase from to .

Core Output

Depending on what setting you use for ‘Verbose’, this will show you live output from your actual Nexus Node. We don’t recommend every user watch this closely, as it is more technical information. But if you are ever curious to see what is going on under the hood, this is the place to watch.

Migrating Your Legacy QT wallet NXS to Tritium

The following guide contains instructions on migrating your NXS from the Legacy QT wallet to the Tritium wallet.

Before we start be sure to check you have the following which are absolutely essential for this migration.

• The QT wallet legacy wallet.dat file.( It should be named as wallet.dat) or the Private Key (Paper Wallet).
• The encryption password for the wallet.dat file.

Recommended Security:

We recommend that users have at LEAST 8 characters in their password, and at LEAST 4 characters in their PIN. This will make offline password cracking take 50 billiion years to break the password/pin combination.

DO NOT USE COMMON WORDS FOR YOUR PASSWORD, THIS WILL LEAVE YOU VULNERABLE TO DICTIONARY ATTACKS THAT COULD DRASTICALLY DECREASE THIS RESISTANCE.

We therefore recommend you using secure random number generators for your password:

$ openssl rand -base64 8

xrMBADJZv48=

Windows Random Number Generator:

https://slproweb.com/products/Win32OpenSSL.html

1. Go to the above link and download openssl (lite version only) for 32 or 64 bit windows.
2. Install the openssl package with the default options
3. Go to Start > Run
4. In the open box, type cmd and click OK.
5. A command prompt window appears.
6. cd \Program Files\OpenSSL-Win64\bin Type this command at the prompt and press Enter. (Change Win64 to Win32 if you have 32 bit version installed, also check the command is case sensitive - type exactly)
7. openssl Starts openssl (The command prompt changes to OpenSSL>.)
8. rand -base64 8 Type this command at the prompt and press Enter. Once you get the code copy it for your password
9. exit To exit openssl and then close the window

Linux Random Number Generator:

Open the terminal and type or copy the commands using Ctrl+Shift+v

1. $ sudo apt update; sudo apt upgrade -y This refreshes the package manager
2. $ sudo apt install openssl This installs the Openssl package
3. $ openssl rand -base64 8 This generates the random number.

The above password generator will provide account security comparable to the above 50 billion years to break, and not include any common words that would enable a dictionary attack success.

Tritium Wallet Install, Bootstrapping, Synchronizing, and Creating User Account

1. Download the Nexus Tritium wallet on your computer. Nexus provides wallets for windows, Mac and Linux.
2. Once you download is complete verify the installer integrity. Do not skip this step.
3. Install and run the wallet and at first launch it will ask to ‘Bootstrap the Database’ click ‘Yes, Let’s Bootstrap it’ and it will download the database and on completion will extract it to the core data folder.
4. The wallet will synchronize the last few blocks and on completion you can see a check mark icon at the top right.
5. You can double check the block count at https://explorer.nexus.io/
6. Create a user account by clicking the ‘User’ icon on the top right corner and selecting ‘Create new user’.
7. In the ‘Create new user’ box enter user name, password and PIN. Click on ‘CREATE USER’, this opens the “Confirm your password and PIN” box, enter your password, PIN and click ‘Confirm’, this creates the new user. It will take 2 blocks to confirm your new user account and a message will be displayed on the top left corner.
8. Log in to your user account by clicking the ‘User’ icon on the top right corner and selecting ‘Log in’. In the Log in box enter your user name, password and pin and click ‘Log in’
9. If your credentials are correct you will get a message on the top left corner “Logged in as ‘User name’”

Migrating Legacy NXS to Tritium

Wallet.dat Migration:

1. Click on the ‘User’ module on the bottom bar and you will be taken to the ‘Accounts’ page where the two accounts created by default are listed. The accounts are ‘default and ‘trust’



2. Copy the address to where you want to send NXS, by hovering on the address box and clicking it (or use the copy button on right of the address) to copy to clipboard. (If you want to stake, your coins have to be in the trust account only.)



3. Go to Help menu and click on “Open Core Data Folder” which will open the core data folder.



4. Close the wallet.
5. Copy your legacy wallet.dat file in the core data folder opened in step 3 (This will replace the existing wallet.dat file created at start. If you have any NXS do back it up)
6. Run the Tritium wallet and then go to ‘File’ menu and click on “Switch to Legacy Mode”.



7. Go to the lock icon on top right corner and It will prompt you for the encryption password to open wallet.dat file. Enter password and click ‘Log In’ . On a successful login “Logged in Successfully” message is dispalyed at the top left corner.



8. Click on ‘Core’ tab and click “Rescan Wallet” and after completion click on “Reload” button to reload your transactions. After it is complete your balance will be visible on the overview or the ‘User’ module Accounts tab.



9. Next step is to send your legacy balance to the Tritium address. Click on the send module on the bottom bar which opens the Send NXS page. Here “SEND FROM” is your legacy address, “SEND TO” is the Tritium address copied in the earlier step. “NXS AMOUNT” enter the full amount of NXS in your legacy wallet and click ‘send’. (This will send your full legacy balance to your Tritium address)



10. On a successful transaction go to File menu and click on “Switch to Tritium Mode”. After a few blocks you should see your NXS balance in the wallet overview.
11. Be sure to set your Recovery phrase by clicking on the ‘User’ icon on the top right and clicking “Set Recovery Phrase”.

Private Key Migration:

1. Run the Tritium wallet and then go to ‘File’ menu and click on “Switch to Legacy Mode”.



2. If you have encrypted the legacy wallet then unlock the wallet. Go to the lock icon on top right corner and It will prompt you for the encryption password to open wallet.dat file.



3. Click on ‘Settings’ module in the bottom bar, go to ‘Security’ tab on the top and go to the “IMPORT PRIVATE KEY” window.



4. Fill in the Account Name (Label to distinguish the account, except ‘default’ which is already created by default) and the Private Key and click ‘Import’
5. Go to the user icon on top right and select ‘My Addresses’, this will open a window which will list all the legacy addresses for your account. You will find your new account listed here. (The ‘default’ account is created on automatically at wallet start)



6. Go to ‘Settings’ module in the bottom bar (gears icon), click on ‘Core’ tab and click “Rescan Wallet” and after completion click on “Reload” button to reload your transactions. After it is complete your balance will be visible on the overview or the ‘User’ module Accounts tab.



7. Next step is to send your legacy balance to the Tritium address. Click on the send module on the bottom bar which opens the Send NXS page. Here “SEND FROM” is your legacy address, “SEND TO” is the Tritium address copied in the earlier step. “NXS AMOUNT” enter the full amount of NXS in your legacy wallet and click ‘send’. (This will send your full legacy balance to your Tritium address)



8. On a successful transaction go to File menu and click on “Switch to Tritium Mode”. After a few blocks you should see your NXS balance in the wallet overview.
9. Be sure to set your Recovery phrase by clicking on the ‘User’ icon on the top right and clicking “Set Recovery Phrase”.