Nxt client interface

From Nxtwiki
Jump to: navigation, search

Introduction

This guide describes the Nxt client interface as of Nxt software release 1.5.10. It assumes that you have already installed the NRS (Nxt Reference Software), opened the client in a browser and logged in, as described in Getting Started. For further specific questions and common problems please consult the Faq pages.

The NRS uses a client-server architecture.

The NRS server is a Java application with two interfaces:

  • one for communicating with other servers through the Internet (forming a network of nodes) and
  • one for responding to requests from clients through its API (Application Program Interface).

The NRS client, often referred to as the Nxt Wallet, is a browser-based interface to the NRS server (via the API), .

Client Interface Layout

NCI layout.png

The client window is organized into three main areas:

The Header Bar

NCI header bar.png

The blue bar at the top of the Nxt client interface is the header bar, with the following buttons available:

Button Function
TopMenu sidebar toggle.png Clicking this button toggles the visibility of the Sidebar Menu.
Send NXT Clicking this button opens a window to send NXT to another account. See How to Send Nxt.
Send Currency Clicking this button opens a window to send a Monetary System currency to another account. See Transfer a Currency.
Send Message Clicking this button opens a window to send a message to another account. See How to Send a Message.
TopMenu unconfirmed.png Clicking this button causes the My Transactions screen to appear in the Display Area, with the Unconfirmed filter selected. The number in the button graphic indicates the current number of unconfirmed transactions associated with the logged-in account.
TopMenu phasing.png Clicking this button causes the My Transactions screen to appear in the Display Area, with the Phasing filter selected. The number in the button graphic indicates the current number of pending phased transactions associated with the logged-in account.
TopMenu notifications.png Clicking this button causes the drop-down Notifications Menu to appear. The numbers in the button graphic are the numbers of unread notifications of confirmed transactions. The first number is the number of distinct transaction types; the second number is the total number of transactions.
TopMenu contacts.png Clicking this button causes the Contacts screen to appear in the Display Area.
TopMenu settings.png Clicking this button causes the drop-down Settings Menu to appear.
TopMenu help.png Clicking this button causes the drop-down Help Menu to appear.
TopMenu logout.png Clicking this button causes the drop-down Logout Menu to appear.

Notifications Menu

NCI notifications.png Each item in the Notifications drop-down menu corresponds to a transaction type, with the number of unread notifications of that type shown in a (default red) circle.

Clicking on a menu item causes a screen relevant to the transaction type to appear in the Display Area; the item is removed from the menu and the notifications are marked as read.

A link is provided at the bottom of the menu to mark all notifications as read.

Settings Menu

NCI settings menu.png The Settings Menu contains items that cause the following screens to appear in the Display Area:

and that open the following windows:

  • Generate Token - Generate or Validate a token.
  • Calculate Hash - Calculate the hash of a secret phrase for transaction phasing By Secret.
  • Transaction Operations - Broadcast Transaction, Parse Transaction and Calculate Full Hash tabs. See Escrow Operations.
  • File Upload - Upload tagged data. See Prunable Data

Help Menu

NCI help menu.png The Help Menu contains an item that causes the News screen to appear in the Display Area.

It also contains items that link to helpful Nxt-related websites, including tutorials for several Nxt client interface features.

Logout Menu

NCI logout menu.png The Logout Menu contains three logout options:
  • Logout - Logout the currently logged-in account and return to the login screen.
  • Logout and Stop Forging - The NRS server keeps forging for an account once logged-in with its passphrase even after logout, unless requested to stop doing so or shut down.
  • Logout and Clear User Data - User-specific data such as Settings, Contacts, and Asset Exchange bookmarks are stored on the local system in a browser-managed database until cleared.

The Sidebar Menu

The top section of the Sidebar contains account-related information and controls. Beneath the account section is the main menu of the client, consisting of buttons which cause various screens to appear in the Display Area. Buttons with a > symbol to the right also make visible submenu items each with a >> symbol to the left.

NCI sidebar.png

No Name Set - Clicking on this will open a window which allows you to assign a name to your account; the assigned name will be shown instead.

Account ID - This is the currently logged-in account ID in Reed-Solomon format. Clicking on it will open a box allowing you to copy it to the clipboard or to switch to a different account if any account IDs were saved in a cookie during previous logins.

Unconfirmed Balance - This is the confirmed NXT balance of the logged-in account, less any unconfirmed outgoing transactions.

Connected - Indicates that the NRS server is connected to other servers in the Nxt Network. Clicking on it causes the Peers screen to appear in the Display Area.

Not Forging - Click on this to enable/disable Forging.

Search By ID - Allows you to to search for an Account ID, a Transaction ID or a block ID. Simply enter the ID and click on the magnifying glass or press enter, causing a window to open with detailed information and controls. Account IDs can be in either numerical or Reed-Solomon format.

Dashboard - This menu item is activated and its submenu is visible when the client is started.

Asset Exchange - Accesses the Asset Exchange.

Monetary System - Accesses the Monetary System.

Voting System - Accesses the Voting System.

Marketplace - Accesses the Marketplace.

Messages - Accesses Arbitrary Messages.

Aliases - Accesses the Alias System.

Plugins - Accesses client Plugins.

The Display Area

The following screens can appear in the Display Area. A button labeled >_ can be found in the lower right corner of this area; it opens a Console Logging window which displays the results of API calls made to the NRS server by the client in real-time, useful for debugging, when enabled on the Settings screen.

Dashboard

The Dashboard appears in the Display Area when the client starts. It gives an overview of the logged-in account which can require several minutes to become up-to-date after starting the NRS.

NCI dashboard.png

NRS Version - The NRS (Nxt Reference Software) version currently running. Clicking on the version number opens the NRS Info window with an NRS State tab displaying system information (after a delay) and an NRS Update tab for checking and updating the NRS version.

Account Balance - The confirmed NXT balance less any unconfirmed outgoing transactions. Clicking on More Info opens the Account Details window that includes an Account Leasing tab for leasing the forging power of your account to another.

Assets Value - The combined value of all owned assets measured in NXT. The number of assets owned is indicated in parentheses. Clicking on More Info causes the My Assets screen of the Asset Exchange to appear in the Display Area.

Currencies - The number of currencies owned. Clicking on More Info opens the All Currencies Screen of the Monetary System containing a button for switching to the My Currencies Screen, which displays only the currencies owned.

Purchased Products - The number of products purchased in the Marketplace. Clicking on More Info causes the Purchased Products screen to appear in the Display Area.

Pending / Completed Sales - The number of pending / completed sales in the Marketplace. Clicking on More Info causes the My Pending Orders screen to appear in the Display Area. The My Completed Orders screen can be displayed by clicking the My Completed Orders submenu item under the Marketplace Sidebar Menu item.

Messages - The total number of messages sent and received. Clicking on More Info causes the Messages screen of the Arbitrary Messages System to appear in the Display Area.

Aliases - The number of aliases owned. Clicking on More Info causes the Aliases screen of the Alias System to appear in the Display Area.

Last Updated - The local time of the most recent block received from the Nxt network. The current height of the blockchain is indicated in parentheses. Clicking on More Info causes the Blocks screen to appear in the Display Area.

Recent Transactions - A list of recent transactions. See the My Transactions screen for more information. Clicking on View More causes the My Transactions screen to appear in the Display Area.

My Transactions

Transactions associated with the logged-in account are displayed in reverse chronological order on this screen. When there are many transactions, they are displayed on multiple pages accessed by the page buttons at the bottom of the screen. The number of displayed transactions can be reduced by filtering them according to transaction type and further according to transaction subtype. Also, pending phased transactions of any type can be displayed, as well as unconfirmed transactions associated with all accounts.

When the screen is first opened from the Sidebar Menu, all transactions are displayed. To filter the transactions, click on one of the graphic symbols in the top row, first hovering the cursor over it to see a descriptive tooltip. For finer filtering, click on the Show Type Menu button to reveal the subtype graphic symbols and text descriptions in the next row. The subtype row displays only the subtypes of the type selected in the top row. If All is selected in the top row, only the All Types graphic appears in the subtype row. An example of filtering is shown below.

NCI transactions.png

Transaction - The transaction timestamp, in local time. Click on it to open the Transaction Info window, which gives transaction details and a list of optional actions related to the transaction.

Envelope - Indicates that the transaction contains a readable message, one that has not been pruned. Click on the transaction timestamp to read the message in the Transaction Info window.

Type - The type/subtype of the transactions with a graphic and text.

Amount - The amount of NXT that was sent/received. Received NXT is shown in green, preceded by a plus sign. Sent NXT is shown in red, preceded by a minus sign.

Fee - All transactions require a fee paid in NXT. The fee is paid by the initiator of the transaction and as such is shown in red if initiated by the logged-in account, otherwise it is shown in black.

Account - The accounts involved in the transaction, with an arrow showing the direction of the transfer. If no other account is involved, a slash (/) is shown as the recipient. Contact labels are used when available in place of account IDs, but and the logged-in account is always indicated by You. Click on an account label/ID to open the Account Info window, which gives account details and a list of optional actions related to the account.

Gavel - Indicates the phasing poll status of phased transactions.

Conf. - The number of confirmations. A newly created transaction that has not yet been included in the Nxt blockchain is shown as having dash (-) confirmations. When the transaction gets included in the block at the top of the blockchain, the number of confirmations becomes 0. Each block added after that increases the number by one. Ten confirmations is considered safe for small transactions. 720 confirmations is considered safe even for very large transactions, because the blockchain can no longer be reorganized.

Filtering This screen is an example of transaction filtering by the type Messaging/Voting/Aliases (type 1) and further by the subtype Alias Assignment (subtype 1). Click Hide Type Menu to hide the subtype row.

NCI transactions filtered.png

Contacts

Contacts are convenient labels for Nxt accounts, useable when sending NXT or messages. They are stored in a local database by your browser, not on the blockchain. As such, they can be erased by the Logout and Clear User Data option of the Logout Menu.

This screen lists contacts in alphabetical order along with controls for modifying and deleting them. In the upper right corner of the screen are buttons for opening windows to add a contact to the list or to export/import the entire list to/from a JSON-formatted file.

NCI contacts.png

Name - The contact label. Click on it to open the Update Contact window where the Account ID, Email Address and Description fields can be updated.

Account ID -- The Reed-Solomon address of the account. Click on it to open the Account Info window.

Blocks

This screen displays information about the Nxt blockchain.  The blockchain represents the full history of transactions on the Nxt network, with each block in the chain containing up to 255 transactions.  Nodes on the Nxt network compete to create new blocks from unconfirmed transactions through a process called Forging, at a theoretical rate of about one per minute although usually less often in practice.

The (default blue) boxes near the top of the screen display statistics for the blocks listed beneath them in reverse block height order. The page buttons below the list allow older blocks to be viewed. Click on the Forged By You button in the upper right corner to view only those blocks forged by the logged-in account.

NCI blocks.png

Height - Block height.  Each block in the blockchain is numbered sequentially beginning with zero, so the higher the number, the more recent the block. Click on this number to open the Block Info window, which includes details about the the block and all of the transactions it contains.

Date - The local date and time that the block was generated.

Amount - The total amount of NXT transferred by transactions in the block, not including fees.

Fee - The total transaction fees in the block, in NXT.  All transaction fees are transferred to the account that generated the block.

# TX - The number of transactions included in the block.

Generator - The ID of the account that generated (forged) the block. This account collects all the fees for this block.

Payload - The combined size of all of the transactions in the block, in bytes.

Base Target - A dynamically adjusted Forging target, designed to maintain an approximately steady rate of block generation. When blocks are generated too frequently, the base target is adjusted smaller by the Nxt network, which makes it less likely that the random numbers computed by each active node every second will be less than the base target multiplied by the node's effective balance. If all existing NXT were actively forging, the base target would average about 100%. If it averages about 400%, for example, then only about one-fourth of existing NXT are actively involved in forging.

Peers

This screen displays information about Nxt network peer nodes connected to the local NRS server.

The (default blue) boxes near the top of the screen display statistics for the peers listed beneath them. Click on the Add Peer button in the upper right corner to add a peer to the list by specifying its address.

If a peer becomes disconnected the (default green) checkmark to the left will change to a (default gold) x. You can attempt reconnection by clicking on the Connect button to the right.

Any peer can be blacklisted by clicking on the Blacklist button. The peer will be disconnected for at least 10 minutes unless manually reconnected by clicking on the Connect button.

NCI peers.png


Address - The IP address or domain name (if known) of the peer node.

Weight - The weight of a hallmarked peer node.

Downloaded - The amount of data (in bytes) downloaded by the peer node in the current session.

Uploaded - The amount of data (in bytes) uploaded by the peer node in the current session.

Application - The name and version of the server software running on the peer node.

Platform - The platform of the peer node, as specified by the nxt.MyPlatform property in the properties file.

Settings

Settings affect the behavior of the client. They are stored in a local database by your browser, not on the blockchain. As such, they can be reset by the Logout and Clear User Data option of the Logout Menu.

NCI settings.png

News

This screen provides a summary of Nxt news items from various forums, blogs and websites. Clicking on a news item opens the full post or article in a new tab or window of your browser.

NCI news.png