Nexus Wallet Guide

Menu...

WALLET SUPPORT

If you have any wallet related issues, or any general questions please join one of the Nexus Community Channels 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.

Disclaimer and loss of password

NXS is a peer-to-peer digital currency 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 personal 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 an encrypted Nexus 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 encryption password.

Please make sure to keep your password and private keys extremely safe, and backed up.

Disclaimers out of the way, now we can get started.

SYSTEM REQUIREMENTS

What are the minimum system requirements to run the Nexus Wallet?

  • 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

Getting Started

The Nexus Wallet can be accessed from any Mac, Windows or Linux computer simply by downloading and installing the desktop application.

Step 1 – Downloading

Download the wallet from the Nexus website or from Github.

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 v1.2.3
  • Windows Installer
    f4f1f76d5c7a3ca845e9ebc5281c3d0fb4a09f75bf08ab6024a4aafcd1db44ec5b274a31c6a1d17b1c849e28762cf8ad6862c768aaa5f855e4c969a76b70b89b
  • Windows Unpacked
    0caab60ba635edfe85c4774a5843bede918c614a9861592248a137a8bc5f705cf4d12a07dcc205e9443fb1da146d67682f08fb9f4e9a2ac0ce90f10dcd23055d
  • Mac OSX Installer
    4f673ff177c9c5e6a9d66541046f27f859281648049ba48b88067fc77df9c55c79c435949020d33dbf9ced072f96a580175885bde6cfac239c3694a754b01c58
  • Mac OSX Unpacked
    f7797c6ceeb29a4b5cbd14bd8964639d939f3fc89fe9ba9ccb4a6dcaa4bf77e17eb0148b209d4479933da1c3b1e699a6ab12147599a234e7a97f1e842f4de756
  • Linux Deb
    50a713fe3e2e306e4a072df716c909aeaefbe122d15b3bec27429017f046c725675f5ff18e2c61e2373156cfec8dca4b5cd2cc5dca8fe67519f82c93e9b039b8
  • Linux AppImage
    ad433f01d512ef2678a0b3c417c8afedc87e0161d9a7ea4046d35fa2a190b7869d6dc36ee36ef9d0f76c6d3d3689b7037a94154f68506bf5b088d42cf7691707
  • Linux Snap
    f04f4071d74b57f06a13bc2964b0aa6b338ef4578c4aad64062022016a09593e736d4227778fc13d6140e0a2d0b2843a06a995951304c566b69410232dbf959e
Step 2 – Installing

After downloading the wallet, follow the instructions to install the application. This will be a pop up tab when clicking on the downloaded wallet file. This file is likely to appear in your most recent downloads.

Mac -> Simply drag the Nexus logo into the Application file, and follow the instructions.

mac-install

Windows -> Simply save and then run the .exe file.

windows-run1

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

linux-install
Step 3 – T&Cs

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, EXPRESS 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.

Step 4 – Synchronizing

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

Synchronization can take place in two ways :

  • Letting the wallet catch up with blocks on its own by just leaving the wallet open : approx 10 hours.
  • ‘Bootstrapping’ the wallet (downloading the recent database) : approx 1-2 hours. To download the recent database please follow these instructions :

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

backupimage recentdb

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

botstrap

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

After your wallet has downloaded the Recent Database, you will see the notification ‘Extracting Database’. You will need to wait for this to complete. Again, if you click ‘Abort’ all progress will be lost.

Once the extraction has finished, you will see the notification ‘Rescanning Database’, which will ensure that your wallet is up to date with the most recent transaction records.

Upon completing the bootstrap, the wallet will show ‘Synchronising 99%’ (if you hover over the left icon in the top right menu). This is perfectly normal, and highlights that the final 1% of ‘catching up’ is taking place which takes place automatically. This should take 10-15 minutes.

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 catch up. 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…’ for longer than 5 minutes, your core is not loading. In this scenario, we recommend restarting the wallet, and if that does not solve the problem, then please restart your device.

NOTE : If you previously had a wallet on the computer that you are using, it will AUTOMATICALLY import your wallet.dat into the new wallet. You do not need to do anything but sync your 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.

‘Synchronizing’, indicates that the wallet is catching up with the Nexus Blockchain, which can take some time.

sync

When your wallet is ‘synchronized’ with the Nexus Blockchain, you will see a tick at the top right hand of your wallet. It is now ready to use.

sync
Step 5 – Encrypting

By encrypting, we mean password protecting your Nexus Wallet.

A newly downloaded wallet is unencrypted. The lock icon in the top right hand corner of your wallet will look like this as soon as you download the application :

backupimage

After you have installed the wallet and it is fully synchronized, a pop-up will prompt you to encrypt your wallet. Encrypting your wallet is recommended, as without encryption, NXS can be sent from your wallet without requiring password approval.

To encrypt your wallet, please follow these instructions :

Settings -> Security -> enter password -> re-enter password -> Encrypt and Restart

It is imperative that your encryption password is both remembered and kept safe.

If you lose your encryption password, you will not be able to withdraw any NXS from your wallet, essentially making your coins worthless. Since the encryption of your wallet is based on the password that you chose, and the encryption process is facilitated by Nexus which is a decentralized system, there is no central authority to reset your password for you. So please ensure you keep your password safe. After encrypting your wallet, close and re-open the application. Upon re-opening your wallet, the lock icon in the top right hand corner will look like this :

lock-icon
Step 7 – Enable staking

By encrypting, we mean password protecting your Nexus Wallet.

You must be ‘logged in’ to the wallet or have the wallet ‘logged in for staking and mining only’, in order to stake your NXS.

You must have ‘staking enabled’ in order for your wallet to receive trust payments. This is to prevent people from unintentionally staking coins.

Step 1

Once logged in, you can enable staking by following these instructions :

Settings -> Core -> ‘Enable staking’

enable-staking

When this setting is enabled, the following will be displayed when hovering your mouse over the Nexus logo icon in the top right hand corner :

Step 2

A wallets first Proof of stake block is referred to as a ‘Genesis’ transaction. This may take three days or more to receive, and will require the wallet to be open and connected to the internet.

The receipt of a Genesis NXS transaction will be indicated in the page named ‘Transactions’.

After receiving a Genesis transaction, a staking wallet will receive ongoing ‘Trust Transactions’, as further staking rewards. Please note that your Genesis transaction is likely to be larger than that of subsequent Trust Transactions, and these will vary in size.

How do I unlock my Wallet to send NXS while staking?

If you wish to send NXS, and your wallet is logged in for ‘staking and mining only’, please do the following :

  • Settings -> Security -> Log Out
  • Settings -> Security -> Log in (with the ‘Login for staking only’ mode disabled (circle is grey and to the left).

By hovering your mouse over the Nexus logo an overview of your staking values are displayed. These values are also on the right hand side of the Overview page, and explained in the wallet features section.

Step 8 – Backup Your wallet

IMPORTANT – After you receive a Genesis transaction, please backup your wallet immediately. For extra security, we recommend storing this backup file on one or more devices. To backup your wallet, please follow these instructions :

File -> Backup Wallet

backup-file

backup-location

or

Settings -> Application -> ‘Backup Wallet’ (Button)

app-backup

You will notice the files are saved as .dat files – this is what is termed backing up your wallet.dat file.

A wallet without a backup could lead to a loss of access to your wallet if you were to experience a hard drive failure, or lose possession of your device. In addition to backing up your wallet after receiving a Genesis transaction, it is also recommended that you periodically backup your wallet every few weeks.

WALLET FEATURES

The bottom menu highlights the different pages of the wallet. These are comparable to the default applications of a smartphone – they cannot be removed :

  • Overview
  • Send NXS
  • Transactions
  • Market Data
  • Address book
  • Settings
  • Console
Overview

The overview is the wallet home page. The purpose of the globe is to show a selection of nodes which your wallet is connected to.

The figures on the left hand side of the Overview page :

Balance (NXS) : Your NXS balance inside of your wallet.

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

Transactions : The total number of transactions you have made inside the wallet. These transactions include incoming payments, outgoing payments, and stake Reward related transactions (Genesis and Trust transactions).

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

Market Cap (USD) :The total value of all NXS. 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 page :

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.

Stake Reward : This value represents your current annual NXS rate of return (%). The rate starts at 0.5%, and can increase to 3.0% after 12 months of consistent staking. staking is a form of mining based on ownership of a digital currency. NXS can only be staked inside the official Nexus Wallet when in staking is enabled, and with a continuous internet connection (24 hours a day, 7 days a week). In return, stakers are rewarded for operating the wallet (a Nexus node) which provides security to the network. The rate increase is nonlinear, slowing in terms of its increase over time. It takes several weeks of consistent staking to reach 1.0% and around four months to reach 2.0%. With this rate, you can calculate the average amount of NXS you can expect to receive over time for staking.

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 tell if you are in sync or not, an easier way, is to look at the far left icon in the top right hand corner of the wallet. Synchronizing : not up to date. vs. Synchronized : up to date.

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.
  • Trust score takes 84 days of successful staking to reach 50% trust weight, and 364 days to reach 100%.

To read more about staking, please see Stake NXS, the FAQs, or read the whitepaper Nexus Proof-of-Stake with Tritium Trust(for advanced staking information).

Send NXS

Features

Send From : Select the address you wish to send NXS from. The list contains the contacts you have saved in ‘My Addresses’.

Send To : Either copy and paste the payee address in this box, or save the payee as a new contact in your Address Book, and select them in the Send To dropdown.

Fee : This transaction fee is the one saved in Settings -> Core -> Optional transaction fee

Message : Enter a message for your transaction.

Move NXS between accounts :

If you wish to see the NXS balance for your different accounts, click on the top right hand corner wallet icon :

Transactions

The transactions page displays all the wallet transactions, and breaks them down by type :

Receive : A Transaction that has been sent from another address to your wallet

Sent : A Transaction sent to another address

Genesis : The Genesis transaction for staking

Trust : Stake reward transactions

Pending : An unconfirmed transaction set by the user’s settings (default 3 confirmations)

Immature : Generated blocks that have not been confirmed by the network (10 confirmations)

Generate : NXS Generated by the network

Step 5 – Encrypting

This page provides market data from two digital currency exchanges : Binance & Bittrex.

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

Address Book
  • The first icon, representing My Addresses (also in the top right hand corner of the wallet) displays your saved NXS addresses. Here you can also create new NXS addresses.
  • The second icon, New Contact, allows you to add new addresses to your Address Book. Addresses saved in your Address Book will appear in the ‘Send To’ section of the Send NXS page.
  • The third icon, ‘Export Contacts’, allows you to export your contacts in a .csv file.
  • This icon on the top right corner will take you to your NXS addresses.
Settings

There are 5 tabs within settings : Application, Core, Security, Style, Modules.

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

A) 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 : Click on the Nexus logo in the bottom right hand corner menu, and then click ‘X’

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 digital currency wallets, the Nexus Wallet notifies you of an update to be accepted, comparable to regular computer software updates.

We recommend 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 Resources section on nexus.io.

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

Fiat Currency

The option selected will be the currency in which the Balance, Market Price, Market Cap & 24hr change are represented 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 are allowed to 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.

Backup Wallet

IMPORTANT – Backing up your wallet regularly is recommended. For extra security, we recommend storing this backup file on one or more devices. Weekly, bi-weekly or monthly backups are recommended, but for maximum security we recommend the following :

  • Back up after encryption
  • Back up after Genesis transaction
  • Back up periodically (aim for weekly, but at least monthly).

To backup your wallet, please follow these instructions :

Click on Settings and then go to the Application Tab (or File > Backup Wallet) and click Backup Wallet.

This will copy your wallet.dat file with the date and time in the NexusBackups folder created in your home directory. It is recommended to also save the wallet.dat file on a device off of your computer, creating a backup by copying the file onto a flash drive. Make sure to have multiple backups of your wallet.dat file.DO NOT LOSE OR DELETE YOUR WALLET.DAT FILE.

or

Settings -> Application -> ‘Backup Wallet’ (Button)

A wallet without a backup could lead to a loss of access to your wallet if you were to experience a hard drive failure, or lose possession of your device.

B) Core

Enable mining

With mining 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

You must be ‘logged in’ to the wallet or have the wallet ‘logged in for staking and mining only’, in order to successfully receive your stake rewards.

You must also have ‘staking enabled’ in order for your wallet to receive trust payments. This is to prevent people from unintentionally staking coins.

Step 1 :

Once logged in, you can enable staking by following these instructions :

Settings -> Core -> ‘Enable staking’

When this setting is enabled, the following image will be displayed on the top right hand corner of the ‘Overview’ wallet home page :

Add image

Step 2 :

When your wallet has mined its first Proof of stake block, it is referred to as a ‘Genesis’ transaction. This may take three days or more to receive, and will require the wallet to be open and connected to the internet.

The receipt of a Genesis NXS transaction will be indicated in the page named ‘Transactions’ under ‘transaction details’.

After receiving a Genesis transaction, a staking wallet will receive ongoing ‘Trust Transactions’ as further staking rewards. Please note that your Genesis transaction is likely to be larger than that of subsequent Trust Transactions, and these will vary in size.

How do I unlock my Wallet to send NXS while staking?

If you wish to send NXS, and your wallet is logged in for staking and mining only, you must log out and unlock your wallet :

  • Settings -> Security -> Log Out
  • Settings -> Security -> Log in (with the ‘Login for staking only’ mode not selected (circle is grey and to the left).

By hovering your mouse over the Nexus logo an overview of your staking values are displayed. These values are also on the right-hand side of the Overview page, and explained in the wallet features section.

Rescan Wallet

Used to correct transaction/balance issues, scans over every block in the database. This could take up to 6 minutes depending on your device. Use this tool sparingly.

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.

Manual Daemon Mode

Enable manual daemon mode if you are running the daemon manually outside of the wallet. This will shut down your daemon. We only recommend this setting for intermediate to advanced users that want to keep their daemon up to date with the newest developments before releases are public. YOUR WALLET WILL NOT WORK if you have this setting enabled, and have failed to launch an external Daemon.If this doesn’t make sense to you, we recommend you not enable this setting.

Restart Core

This button will restart the daemon. Do this if you believe your wallet is frozen, and it needs to be refreshed. Upon doing so, on most pages you will see the following text : ‘Loading daemon, Please Wait…’. It should take less than 30 seconds before the wallet is refreshed. If your daemon doesn’t start back up in this timeframe, restart the wallet application.

C) Security

Under the security tab, you can change your password, and import private keys from another wallet.

A private key is what gives you access to your coins, and what is stored in your wallet.dat file. If you are a more advanced user and have made a backup of your wallet private keys, this is the area where you can import them into your wallet.

PLEASE NOTE : you will need to run ‘rescan’ after importing new keys into your wallet. This is because your wallet needs to keep a list of the transactions that are associated with your private keys, in order to build new transactions and spend your funds.

Any keys that are imported into an encrypted wallet will automatically be encrypted up import. You DO NOT need to re-encrypt your wallet after you import new private keys.

D) Style

Render Globe

Turn the globe on the Overview page on or off.

Overview Display

Standard : The wallet comes with this overview display (Globe displayed on the Overview page).

Miner : Changes the 3 tabs in the bottom right of the Overview page : Prime Difficulty, Hash Difficulty, stake Difficulty

None : Blank overview display.

Nexus Address Format

These different address formats are purely for visual purposes only – they do not change the address, and the spaces for ‘Segmented’ format and the ‘…’ in Truncated format are not included when copying and pasting the address.

Theme

We provide two default themes ‘Dark’ and Light’.

Background

We provide two default default backgrounds ‘Twinkling stars’ or ‘Cosmic Light’.

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.

– Reset Style Settings : to revert back to the original wallet color theme. Then scroll down and click : ‘Save Settings’ to implement these changes.

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

E) 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), or have to.

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 <nrequired> <‘[“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 <destination> – Safely copies wallet.dat to destination, which can be a directory or a path with filename.

checkwallet – Check wallet for integrity.

dumpprivkey <NexusAddress> – Reveals the private key corresponding to <NexusAddress>

echo [param]…[param] – Test function that echo’s back the parameters supplied in the call.

encryptwallet <passphrase> – Encrypts the wallet with <passphrase>

getaccount <Nexusaddress> – Returns the account associated with the given address.

getaccountaddress <account> – Returns the current Nexus address for receiving payments to this account.

getaddressesbyaccount <account> – 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 <hash> [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 <index> – Returns hash of block in best-block-chain at <index>

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 <timestamp> – 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 <txid> – Returns a std : :string that is serialized, hex-encoded data for <txid>

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

getreceivedbyaddress <Nexusaddress> [minconf=1] – Returns the total amount received by <Nexusaddress> 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 <txid> – Get detailed information about <txid>

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

importprivkey <PrivateKey> [label] – Adds a private key (as returned by dumpprivkey) to your wallet.

isorphan <hash> – 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 <fromaccount> <toaccount> <amount> 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 <fromaccount> <toNexusaddress> <amount> [minconf=1] [comment] [comment-to] – <amount> is a real and is rounded to the nearest 0.000001 requires wallet passphrase to be set with walletpassphrase first

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

> sendrawtransaction <hex std : :string> [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 – <Nexusaddress> <amount> [comment] [comment-to] <amount> is a real and is rounded to the nearest 0.000001 requires wallet passphrase to be set with walletpassphrase first

> setaccount <Nexusaddress> <amount> – Sets the account associated with the given address.

> signmessage <Nexusaddress> <amount> – 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 <Nexusaddress> – Return information about <Nexusaddress>

> verifymessage <Nexusaddress> <signature> <message>– 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 <passphrase> [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 <oldpassphrase> <newpassphrase> – Changes the wallet passphrase from <oldpassphrase> to <newpassphrase>

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.