Nexus Wallet Guide

Menu...

Introduction

If you have any Wallet related issues, or any general questions please join one of the Nexus Community Channels found in the footer, and post a message asking for help. The Nexus community consists of a diverse array of friendly and helpful individuals - one of which will point you in the right direction whatever your query.

Video

Check out the video below from The Digital Future!

Disclaimer and Loss of Password

NXS is a peer-to-peer cryptocurrency that provides fast, low-cost, borderless, and secure transactions without the requirement of a bank or third-party intermediary. You personally own your NXS and Nexus Wallet, they are not owned or governed by a central authority. This is in direct contrast to a bank, in which the money held inside an account is legal property of the bank rather than the account holder. Nexus provides individuals with economic freedom, and with this freedom comes true responsibility for the safety of your own finances.

The Nexus Wallet is the safest place to store NXS. If coins are stored on a centralized exchange or a mining pool, then that entity has full custody. Third party custody comes with a multitude of risks. To ensure you maintain ownership, we recommend that NXS is held in the new Tritium Wallet. Nexus is a decentralized organization and our software is licensed under an MIT/X11 open source license. You are the sole custodian of your coins, we can not help you if you lose or forget your password or PIN.

Please make sure to keep your password and PIN extremely safe.

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.

How to verify installer's integrity

For better security, you can verify the integrity of the installer you’ve downloaded to make sure it’s original and hasn’t been tampered with. In order to do so, check the SHA-512 hash of the installer by following the instructions and compare the result you got with the correct hash provided below. If the hashes don’t match, please let Nexus team know about that.

 

How to get SHA-512 hash of a file

On Windows

  1. Open Command Prompt (press Windows + R, type cmd into the textbox, then press Enter)
  2. Type this command:
    certUtil -hashfile pathToFile SHA512

    and press Enter (replace pathToFile with the path to the file that you’ve downloaded)

On MacOS (OS X) and Linux

  1. Open Terminal
  2. Type this command: shasum -a512 pathToFile and press Enter (replace pathToFile with the path to the file that you’ve downloaded)

 

SHA-512 Hashes – Nexus Wallet v3.0.3
  • Windows Installer
    0e1dd66b8b6c39f5fd212d147f4d0d63d7843856c14118a2666ef8936773a03cedad575687fee2cd9d2b2d2609f1fe766d9ac42544f2bef38765b38abe0c7d33
  • Windows Zip
    e6a0a263e958cfc3b15137e3abf360c59bd4e3c9e32472ba8b979adbe1f344ef70968497cfe7239b2177eacfc524a01d9942e5c32eab9e1782fe3802909cf036
  • Mac OSX Installer
    78826fef71227384bdbdc14948c9921f52812e6e7de8faf9a8b6c0e3640036bf55acdf1044157bff3f440e3f121f1d0b6628153e33c090964900d6fe919d0d4e
  • Mac OSX Unpacked
    f966829986678cd3481025bfcc24539ac7f7a1e89b989bd6173c10f904433ccf1718f20cdc2154f160c4f358c25c1efdbff74ea7dac2ec806e12546734440cdf
  • Linux Deb
    97e053b1a9c1f0db5c8b009fa9542ed91431eaa941b21d3fc0c24e03562e11d15412164ca7c07b2620f367fed01df9bc3948db4c9da7f9040eb034104f5e3504
  • Linux AppImage
    fd872bc872f37e5d7c54caaa0df17d74ebf989a50bd2d89a8f548f7176a468561c43c523b2ef659b281dd3484b1f11f0ab4a2034ef92350f73777e7ce5d2a63f
  • Linux Snap
    9ba8b8f3fc7c2b40e22cd67dc91bb56e580af979d9be616a9d73444d51a96ad23df4460af4baab5e709978ee75519c5f7150c0c32ddedf8fceb584c189b2ca3a

Install

Follow the instructions on the pop up box to install.

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

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

Click Open

Windows -> Help from a WIndows user

Linux -> Simply click install and type in your password when prompted.

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.

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.

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 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 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. Market Data
  6. Address book
  7. Settings
  8. Console

Overview

The overview is the homepage of the Wallet. The purpose of the globe is to show a selection of nodes which your Wallet is connected to.

Below is an explanation of the figures on the left hand side of the Overview module:

Balance (NXS): Your total NXS balance.

Balance (USD): The USD value of all your NXS balances - calculated by multiplying Balance (NXS) x Market Price (USD). The Wallet comes with USD as the default currency, to change the base currency do the following: Settings -> Application -> Base Currency.

Incoming Balances (NXS): This value shows the value of NXS that is coming into your Wallet, and have yet to be fully received.

Market Price (USD): The value of 1 NXS in your chosen default base currency (in this case USD).

Market Cap (USD): This is calculated by multiplying the Market Price (USD) x Total NXS Circulating Supply.

24HR Change (USD %): The value change in NXS over the last 24 hours.

The figures on the right hand side of the Overview module:

Connections: This refers to the amount of random ‘nodes’ which are connected to yours. Sixteen is the maximum number of connections. More connections generally means your transactions and blocks will relay across the network more reliably. The max value here is 16 connections, but 16 connections are not required. Anything above 4 is adequate.

Block Count: The block count is the ‘height’ of the blockchain. This number allows you to check with one of the Nexus Explorer applications to see if the block you are on is the current block (meaning you are up to date). If the block value on your Wallet does not match that of a Nexus Explorer, then you are not in sync with the Nexus Blockchain and need to ‘Download the Recent Database’ to catch up with the Nexus Blockchain (Settings -> Download Recent Database). Another way to check if you are in sync or not, an easier way, is to look at the left icon in the top right hand corner of the Wallet. Synchronizing: not up to date. vs. Synchronized: up to date.

All the values below relate to Staking.

Stake Rate: This value represents the current rate used to calculate your reward for mining a Proof of Stake block, stated in the form of an annual NXS rate of return (%). The rate starts at 0.5%, and can increase to 3.0% after 12 months of cumulative Staking.

Block Weight: Upon receipt of a Genesis transaction, this value will begin increasing slowly, reaching 100% in 3 days time. Every time you receive a Staking transaction, the block weight resets.

  • Your Wallet must mine a stake block and generate a transaction before it reaches 100% for trust weight and stake rate to keep increasing.
  • If your block weight reaches 100%, it will stay at 100% and both your trust weight and stake rate will begin to decay.

Trust Weight: An indication of how much the network trusts your node. It starts at 1.11% and increases in a nonlinear manner like stake rate does. Your level of trust increases your stake weight (below), thus increasing your chances of mining stake blocks and receiving Staking rewards. It becomes easier to maintain trust as this value increases.

  • For new Wallets Staking Genesis, trust weight is based on coin age with a maximum of 11%.
  • After Genesis, trust weight is a measure of the overall trust score you have accrued. It is displayed as a percentage of the maximum possible trust score.
  • The time investment needed to build trust increases network security.
  • Trust score takes 84 days of successful Staking to reach 50% trust weight, and 364 days to reach 100%.

Stake Weight: The higher your stake weight, the greater your chances of receiving a trust transaction. The exact value is derived from your trust weight and block weight.

  • Stake weight is a derivative value calculated from trust weight and block weight. It indicates their combined impact on chances to generate a Staking transaction.
  • The value will change as trust weight and block weight change.
  • It is for display only as a metric, and is not directly used. Trust weight and block weight values are used.

To read more about Staking, please see the following webpage Stake

For more technical details on Staking, see the following white paper Proof-of-Stake with Tritium Trust

User

The User module displays your username, and your user ID.

Accounts

This page displays your various accounts.

Click on ‘Details’ to show the details of an account account.

The below image is of a Trust Account, which has a special button for adjusting your stake amount. Please refer to the ‘Start Staking’ section to adjust your Stake amount.

Click on ‘History’ to show the history of an account.

To create a new account for NXS, or for a Token, please refer to the ‘Create a Namespace section’.

Staking

The below page shows your Staking metrics:

Stake amount: Shows the amount of NXS in your Trust Account that you have chosen to stake.

Stake Rate, Trust Weight, Block Weight and Stake Weight are all explained in the Overview section.

Unstaked Amount: Shows the amount of NXS in your Trust Account that you have chosen not to stake. Note, this is where your Stake Rewards will come into.

Use the buttons to:

Adjust stake amount: To change the amount of NXS that you would like to stake. Please refer to the ‘Start Staking’ section.

Migrate Stake: To migrate your stake from an old Wallet. Please refer to the ‘Migration Guide’.

Tokens

To create a Token, please follow the steps in the ‘Create a Token’ section.

Use the below button to search for a Token.

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.

Transactions

The Transactions module contains all your Wallet transactions. You can sort transactions by:

Address: A previous address you have sent to.

Name: By NXS or a Tokens that you have previously transacted.

Time Span: You can set a period of time to search in, as seen in the image below.

Operation: You can search by a particular operation, as seen in the image below.

Write:

Append:

Create:

Transfer: Transactions sent to another address

Claim: Transactions that have been sent from another address

Coinbase:

Trust: Stake reward transactions

Genesis: The Genesis transaction for Staking

Debit:

Credit:

Migrate:

Authorize:

Fee:

Legacy:

Click on any transaction to see more details, such as the address, transaction ID, hash and number of confirmations:

Market Data

This module provides market data from two cryptocurrency exchanges: Binance & Bittrex.

By clicking on the exchange logos, you will be directed to the respective NXS order books.

Market Data

This module provides market data from two cryptocurrency exchanges: Binance & Bittrex.

By clicking on the exchange logos, you will be directed to the respective NXS order books.

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

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