From Nxt Wiki
Jump to: navigation, search
This page contains changes which are not marked for translation.

Other languages:
Deutsch • ‎Ελληνικά • ‎English • ‎español • ‎suomi • ‎français • ‎italiano • ‎Nederlands • ‎português do Brasil • ‎русский • ‎українська • ‎中文(简体)‎


Also see: Common problems and resolutions and our Glossary

General Nxt Questions

Where can I learn about Nxt terminology?

We have an excellent glossary here on the wiki. If you read it all, you'll end up with a very good understanding of Nxt's features and terminology.

Is Nxt centralized?

Not at all. The Nxt blockchain is completely decentralized, as are all of its features.

The development community is still small, and some applications that are being built on top of Nxt are being created by single individuals or small teams. For this reason, there are some bottlenecks in the decentralization model. On the whole, though, the Nxt community strongly embraces the principles of decentralization wherever possible.

Strategic initiatives, bounty and project funds are administered by three elected committees:

UPDATE: A New comitee has been formed that replace the three of them into Community Funding Commitee

In addition, any member of the community can submit a Nxt Improvement Proposal to suggest changes to Nxt features, or the addition of new ones.

Is there a Nxt test network?

Yes! Several developers and testers operate nodes that are on a separate "test" network. This network is occasionally reset, when new features are being added for testing. You can create an account on the network by using wesleyh's testnet web client, and then post to this forum to ask for some testNxt. Please create NEW accounts when using the testnet -- do NOT use the same account number that you use on the main network. It will save you some confusion, and is far more secure.

Myths and misconceptions

Nxt is a scam because all Nxt coins are pre-mined

First, it's important to note that Nxt is a 100% Proof-of-Stake (PoS) coin. The only way to implement this form of currency is to issue all available coins in the genesis block. To do otherwise would force the implementation of some form of Proof-of-Work scheme in order to prevent attacks on the network that "fake" stake. Since the creator of Nxt wanted a 100% PoS platform, this was not a desirable course of action. Second, the term "pre-mined" is a misnomer because Nxt coins are not being mined at all.  The original stakeholders in Nxt contributed Bitcoin in order to seed the creation of the 1 billion coins represented in the genesis block, and these coins were distributed among the original stakeholders.  The stakeholders are expected to distribute coins by donating them, using them as "bounties" to pay for work on the coin (software, documentation, translations, support, etc.) that is done by the community. Even the creator of Nxt (BCNxt ) made an investment.  The coins were not generated from nothing! Third, the creation of the genesis block was fully public, and all of the original account numbers and their assigned amounts of Nxt are visible: see https://bitcointalk.org/index.php?topic=303898.msg3652710#msg3652710

If there are no new Nxt to be mined, how do you validate the blockchain and secure the network?

Nxt is a pure Proof-of-Stake (PoS) currency. Users validate the blockchain and secure the network by running a light weight client on any computing device (even one that used to run Windows XP). For doing this users are rewarded with Nxt coin that is collected from transaction fees. In addition, the "transparent forging" feature of Nxt will penalize accounts that do not participate in the mining process by temporarily preventing them from earning transaction fees.

If all coins are in existence already, doesn't this make the original holders of Nxt very wealthy?

Potentially. The original stakeholders of Nxt all made an investment of Bitcoin to seed their holdings, however, with no promise of any kind of success or return on investment.

Doesn't this centralize the Nxt since most coins are in the hands of about 75 individuals?

Most of the original stakeholders have been distributing coins to others as donations, bounties for development and promotion, exchanges, etc. See the next section for more detail. By contrast, Bitcoin is five years old, and half of the total supply of Bitcoin is held by a little over 900 people (source ).

The original stakeholders are hoarding their coins

The genesis block contains 73 transactions, distributing all 1 billion Nxt (except unclaimed coins) among the original stakeholders for the platform. Analysis of the weekly balances in those accounts, performed by wesleyh, shows that the balances have all dropped significantly:

  • Nov 24, 2013: 1,000,000,000
  • Dec 1, 2013: 622,209,864
  • Dec 8, 2013: 406,016,313
  • Dec 15, 2013: 305,742,843
  • Dec 22, 2013: 265,220,001
  • Dec 29, 2013: 248,241,416
  • Jan 5, 2014: 148,913,050
  • Jan 6, 2014: 139,681,005
  • May 22, 2014: 87,568,627

It is possible that coins are simply moving between accounts and are still being "held" by the original stakeholders. However, many of the stakeholders have been actively promoting the development of Nxt by providing donations and bounties to programers, debuggers, translators, and more. Details of some of these bounties and projects can be found in this Google spreadsheet and in the original stakeholders bounty discussion thread on nextcoin.org.

Currency questions

How divisible is Nxt?

Since block 134,000 NXT is divisible up to eight decimal places. NQT, or nxtQuant, is the temporary name given to 0.00000001 NXT (or 10^-8 in mathematical shorthand).

Why are transaction fees so high?

Currently it costs a minimum of 1 nxt to perform any action, whether it's sending Nxt, registering an alias, issuing an order in the Asset Exchange or sending an arbitrary message. No new nxt is ever created, so the fees earned by forgers come entirely from transactions. Forgers need to earn fees as an incentive to keep their nodes running and encode new transactions into the blockchain, thus securing the network.

Nxt is still in its infancy. There aren't a lot of users yet, and features are still being implemented. So the number of transactions per day is still low, but growing. As transactions, and the price of Nxt grows, transaction fees will be adjusted downwards to keep transaction costs reasonable while still sufficiently rewarding forgers and preventing the blockchain from being spammed with unnecessary transactions.

Where can I find charts for the price of Nxt?

Yyou can see the live NXT/BTC price chart in bitcoinwisdom.org, drawing data from the BTER exchange. Another NXT/BTC chart is available at cryptocoincharts.info, which provides a visualization of the price on the DGEX exchange.  You can also visit NXTPrice to find the current price of NXT in USD, and NXT2BTC for the current exchange price of NXT expressed in BTC


What is the difference between the Nxt Server and Nxt Client?

The Nxt Server is the software that implements the core features of Nxt. When we talk about "version 1.1.2 of Nxt" being released, we are talking about the server. It is written in Java, and runs on a command-line interface. The Nxt Client is the web-based interface you use when interacting with Nxt at (or http://localhost:7876/). Developers keep working on new clients for all platforms (even mobile devices!). It's likely that most client softwares will also include the core server software so that you can easily set up and operate Nxt.

Will be the software easier to install and use?

Initially, the Nxt software was of course in very early development and average users found it understandably hard to setup and operate. But these times are gone. The installation procedure for the Nxt core software has become very simple, there's a smooth, user-friendly interface since version 1.0.0, and you also have one-click clients available for Windows and Mac. If you need assistance to get the Nxt core software working in your machine, please check the download and installation instructions.

If you want to visit a portfolio with all the available Nxt clients developed by the community so you can choose the one you like the most, visit http://nxtclients.org/

How do I uninstall Nxt?

It is very easy to remove Nxt from your system. Just stop the Nxt server (it's recommended to close the terminal window using Ctrl+C in Windows; you can also check your activity monitor / task manager and manually kill the "java" process), and then delete the "nxt" folder from your computer.  

Where can I get source code?

Full source code for Nxt is available here. By default, this link will display the "master" branch of the code, but you can also jump right into the current "development" stream.

Wallet, accounts, and account balances

Where is my wallet?

Unlike Bitcoin or other altcoins, there is no local wallet with Nxt.  More specifically, the coin uses a "brain wallet", which is to say that wallets are decentralized and kept on the network.  When you create an account in Nxt, your secret passphrase is used to create your account number.  Once your account number is generated, you can unlock it and access it by using your passphrase on any running Nxt node.

I just created an account but I don't see it in the blockchain explorer! Why?

As soon as you unlock an account with a secret passphrase, the account is created if it does not already exist. But until you send a transaction to your account, it will not appear in the blockchain (or the blockchain explorer). This is because the blockchain is a record of transactions, and not accounts. Send some Nxt to your account, and then check the blockchain again. As soon as the transaction is confirmed (which could take less than a minute), your account will begin to appear.

Is it possible for more than one password to open the same account?

There are 1077 account numbers available in Nxt but there are much larger number of possible passwords, so an obvious question is whether or not it's possible for more than one password to open the same account.

The answer is no, once you have issued one transaction from your account. Here's why: until a transaction is sent from your account, it is not secured by a public key. Once the first transaction is issued, a 256-bit public key for your account is generated. Once this is done, your account number is secured. In the very rare case that someone enters a passphrase that would generate the same 64-bit account number as an existing account, the software will forbid the passphrase and ask you to choose another one.

Can I access my wallet from another computer?

Yes! There is no wallet file in Nxt because all of the accounts are stored on the network.  This is referred to as a "brain wallet". This means your account can be accessed from anywhere... but it also emphasizes the importance of using a strong passphrase, since the passphrase is the only thing that protects your coins from being accessed by others. However, this authorization mechanism might be strengthened later. For security reasons, it is recommended that you only access Nxt software when it is running locally. This helps eliminate the possibility of someone intercepting and recovering your account password.

Can I print a paper wallet like I can with Bitcoin?

No.  The only wallet in Nxt is the network itself -- all accounts are stored there.  The only thing you need to protect is your passphrase, which everything else, including your private key, is derived from.

Is it possible to store Nxt offline?

All Nxt tokens/coins are stored on the network, but it is possible to create an account "offline" that is secured by a 256-bit public key and does not expose your private key to the network. Instructions on how to do this can be found in this post on the nextcoin.org forum.

Do coins left on exchanges earn me more Nxt by forging?

No.  Exchanges that support Nxt have their own internal accounts, and you must transfer your Nxt to the exchange in order to be able to trade. As a result, the exchange could forge using your coins, but you can't.

It is possible that some exchanges may decide to use the Account Leasing feature to "lease back" the coins forging power to their users.

How do I get my first NXT?

There are a number of places for you to get your first NXT!

  • Contribute to the community!  A great deal of work needs to be done to help the Nxt community grow -- everything from contributing documentation, to promoting Nxt, to assisting with translations, to contributing code, and more.  If you want to get involved in the community, join the Nxt slack, or register at NxtForum. There's always tasks needing to be performed. Take one on, and you can earn some NXT for your work.
  • Purchase NXT on Coinimal.com , using EUR Bank Account or card.
  • Purchase NXT on Poloniex , using Bitcoin, Monero or USD Tether.
  • Purchase NXT on bter.com , using Bitcoin.
  • Purchase NXT on Bittrex , using Bitcoin.
  • Purchase NXT on HitBTC , using Bitcoin.
  • Purchase NXT on BTC38 , using Bitcoin.

In some cases, to receive NXT in a brand new account you may need to tell the sender your public key. This is optional for the first deposit one account receives, since as no transactions have been sent from the account yet, it is not known by the Nxt network.

My passphrase doesn't go to the account it should!

Every passphrase is linked to a different account, so if when unlocking your account you find a different account number than expected, it' because the password you just entered does not match the password you entered to originally create your account.

Assuming you properly saved your original password (because you did, right?) sometimes this happens when a blank space or several are accidentally included in the beginning or the end of the password as you paste it into the client login field. Make sure that no spaces or other characters are accidentally included in the password you're entering!

User dmk has written a java program that may help you correct for small mis-spellings or errors in your passphrase. You enter what you think your passphrase is, and the program and it makes small changes to it, generating lots of account numbers for you to compare against your actual account number. If you find a match, you've found your passphrase!

Source code for the program is available at http://github.com/dmkaplan2000/nxt_account_id. If the program helps you recover your account number, please consider making a donation to the developer.


How do I know my client software is authentic?

When new clients are released by the development team, they also publish an SHA256 hash of the file. This basically serves as a "digital signature" for the download. If even one byte of the software is altered or tampered with, the hash value will completely change. Because Nxt is open-source, it is easy for malicious attackers to create "fake" downloads of the software that include backdoors and other exploits.

When you download the software, and particularly if you're not getting it from the original developer release, you should generate an SHA256 has and verify that it matches the one that is posted by the development team. The current version of the client and it's current SHA256 has can be found in the corresponding thread of this NxtForum.org subforum.

If you've never calculated an SHA256 hash before, here's how:

  1. On Windows, an online calculator is easiest: http://hash.online-convert.com/sha256-generator
  2. On Mac OS X, a SHA-256 can be calculated using the openssl command in an open Terminal (the terminal is located in /Applications/Utilities). The openssl command would look something like this: openssl sha256 [FILE_NAME]
  3. On GNU/Linux, the program sha256sum is standard on most versions of the OS. Using the sha256sum command in a terminal would look something like this: sha256sum [FILE_NAME]

Since all Nxt accounts are stored on the network, isn't it possible for someone to guess my "secret phrase" and get easy access to my coins?

This is a very important question. See our Account Security page for an in-depth answer.

In brief: This question emphasizes the importance using a strong, secure password to create your Nxt account.

If you enter a passphrase less than 30 characters long in the Nxt client, you will be warned that you are creating a security risk.  A truly random string of 50 to 60 characters is a far better choice for a passphrase, and will significantly reduce the risk of someone "brute-forcing" your account or stumbling across it or happening to use exactly the same passphrase.  Nxt supports 10^77 different account numbers (that's 100 000 000 000 000 000 000 000 000 000 000 000 000 000 000 000 000 000 000 000 000 000 000 000 000 000 accounts), so the range of possible passphrases is significant. You can use a site like https://howsecureismypassword.net/ to test the strength of your passphrase, and get an estimate of how long it would take a standard computer to crack it.

I've just realized I should have chosen a better password/passphrase.  Can I change my password?

You cannot change your account passphrase in Nxt, because it is actually used to generate your account number.  More accurately, for those of you who know a bit about public-key cryptography: your private key is derived from your passphrase, and your account number is derived from your public key. If you would like to use a different passphrase, just create a new Nxt account using whatever passphrase you'd like.  Once you've done that, use your Nxt client to send your NXT to yourself – from your old account number to your new one.  The transaction fee can be set to the minimum of 1 NXT, so it won't cost you much to make the change.

If transparent forging means that the generator of the next block is known, aren't people running Nxt software vulnerable to DDOS attacks?

This is possible. If it is a concern for you, you should run your Nxt software through a personal VPN service or Tor.


Why is it called forging instead of mining?

With Bitcoin and many other cryptocurrencies, the act of securing and verifying the blockchain results in new coins being created.  With Nxt, however, all possible coins already exist, and accounts earn coins from transaction fees alone.  As a result, it was felt that a new word - "forge" - was needed to describe the manner in which coins are earned.

How does forging work?

With Nxt, coins can be earned through transaction fees.  Once you have a balance of at least 1000 NXT on your account for 1440 confirmations, ie your effective balance is at least 1000NXT, your Nxt account will begin to contribute to the block generation process and can earn NXT for you as long as your account is "unlocked".  The amount of NXT you can earn is dependent upon the number of NXT you hold in your effective balance, the total number of NXT "active" on the network, and the transaction fees included in blocks on the blockchain.  

What is "transparent forging"?

Nxt is implementing "transparent forging", which will allow Nxt software to predict which accounts will forge upcoming blocks. This is basically done by iterating through all active accounts and seeing which one has the highest "hit". Transparent forging will rapidly increase transaction processing, since the account that will forge the next block will be known. Another benefit of this feature is that accounts that are due to forge, but do not, will be penalized by having their forging power temporarily reduced to zero.

Why do I have to buy Nxt coins in order to forge them?

If you´d like to own some Bitcoin, or any of the other altcoins, you have to invest in mining hardware to be able to mine some coins. With Nxt, you buy an actual amount of coins and that allows you to forge. There are no additional costs, and no expensive mining hardware is needed.

I have some coins in my account. How can I start processing transactions and forging coins?

If you are running the Nxt software on your computer, have your Nxt account unlocked, and more than 1000 NXT in your account, you will be able to join the Nxt forging process! Officially, you can start processing transactions and forging NXT once youe effective balance reaches 1000 NXT, after 1440 confirmations. This normally takes about 24 hours, as Nxt blocks are generated once per minute on average. Once you have reached this milestone, the message "forging" should appear under the number of your account on the top left, and the green "forging" indicator will light up. If it says "not forging" just click it and it will start.

Do I have to leave the client open in order to forge coins?

No.  Once your server is running, simply leave your account "unlocked", and then you can close your web browser.

What does it mean to "leave my account unlocked"?

When you type your secret passphrase into the Nxt client window, your account will be "unlocked" in your server software.  Once it is unlocked, it will stay unlocked until you specifically lock it again, or until you stop your server. To unlock your account, access the Nxt Client by opening and log in as "Returning User" with your secret passphrase. This will take you to the client interface, with your account number shown at the upper left of the client window.  At this point, you can close your web browser and your account will remain unlocked on the server. Please note that you should keep the server window running if you want to forge with your account! An alternative to this is using a Forging Pool to lease your forging power to a pool without sending your coins anywhere. See also Account Leasing.

Suppose I lock my account (for example, by means of shutting down the server). The next time I unlock it, is the time I remained unlocked counted towards generating my next block?

No. Think of your chance of generating a block a little bit like entering a prize draw. When a block is being created and your account is unlocked, it is like you have one prize draw ticket in your hand for every NXT coin you own. Everybody else who has NXT coins also has prize draw tickets for all of their coins. Someone is going to win the prize draw, so your chance of winning depends entirely on how many tickets you have, versus the total number of tickets entered in the draw. Now, imagine that to win the prize, you also have to be in the room when the winning ticket is drawn. If your account is "locked" or your server is not running, it is as if you are not in the room – you cannot win the prize. Once a block is generated (meaning someone has won the raffle), a NEW prize draw is started, with all-new tickets, based on who is in the room when the new prize draw begins. So: you have zero chance of generating a block when your account is locked or your server is not running. And since the generation of each new block is NOT dependent on the result of previous block, you do not get any credit for the time that your account has been locked.

How can I see if my account has forged a block?

If you forge a block and receive a reward, your client will show an incoming transaction for the amount of the reward. The source of the deposit will a block identifier instead of an account identifier. Also, the 'Forge Balance' in your Client will show the total NXT you have earned so far by forging in that account, and 'More Info' will give you the details of the blocks you forged and the amount of fees in NXT you earned forging every block.

How much Nxt can I earn by forging, and how often will I get it?

You can start processing transactions and earning Nxt after the first amount in your account is confirmed 1440 times; then an estimate of the time before your software will forge a block will be shown at the top of the "Blocks" widget. It is very important to note that block generation is essentially a random process, so the best anyone can do is estimate how long it might be before you generate a block. In the Nxt client, you will see text that says "you can generate the next block in X days....": this is just an estimate of how long it could take to generate a block, based on your current probability. The estimate will vary from minute to minute, because the probability varies from minute to minute. Here is a mathematical walkthrough of how Nxt coins can be earned from transactions:

  • Every 24 hours, there *should* be 1440 blocks added to the chain. This is based on an average block generation time of one block per minute. But current rates are a bit over half of that. These blocks represent transactions for the total volume of coins (1 billion)
  • Your probability of forging a block depends on your share of the total number of coins that are active on the network. If all available coins (1 billion) were used for active mining, then an account balance of 694,444 NXT (1 billion divided by 1440) would mine 1 block per day. However:
    • coins moved to a brand new account must wait for 1440 blocks to mature
    • some owners don't bother with mining, don't leave their Nxt software running, or their Nxt software crashes, so only portion of all coins are actively mining at any point in time.
    • the number of active coins on the network varies from one block to the next
  • If you look at the "recent blocks widget" in the Nxt client you will see a red-white target icon in each block. If you divide 100% by the target value you'll get the portion of coins that was used for mining that block. (Note: Because blocks are generated once per minute, you should take an average value of these targets, since they fluctuate from minute to minute)
    • For example, if the average target value is 400%, then only 100/400 = 25% of coins are mining blocks.
  • Now you can calculate an approximate value of how many blocks you might create per day by multiplying the number of coins you own by the absolute value of the target (e.g. the absolute value of 400% = 4), and then divide by 694,444.
    • For example, if you have 50,000 Nxt coins and the average value is 400%, you could forge 0.288 Nxt blocks per day, which translates to one block every 3 or 4 days.
  • The number of coins you earn from finishing a block depends on the number of "fee coins" in the block.  The minimum fee per trade is 1 coin, and the number of trades in a block will vary. A block can contain a maximum of 255 transactions.  It is also possible for blocks to be empty.

How much Nxt do I have to have to forge 1 Nxt per day?

This is very difficult to estimate because forging is based on probability, and because of the way the proof-of-stake mechanism operates. From minute to minute the number of active coins on the network varies, so your likelihood of forging always varies. Experienced Nxt holders have observed that a balance of a few hundred thousand coins is necessary to forge blocks on a daily basis.

Can I forge Nxt more quickly by running multiple servers and multiple accounts?

No.  Your ability to forge Nxt depends solely on your total account balance as a percentage of all available coins.  This is what sets Nxt apart as a pure "Proof-of-Stake" cryptocurrency.  CPU power, GPU (graphics processor unit) power, and the number of servers you run have no effect – in fact, you could even forge Nxt on a very old, low-power computer!

The Nxt Alias System

What is the alias system?

See the feature documentation for the Alias System for a general description

How do I create an alias?

See our How-To page on creating aliases.

How much does it cost to define an alias?

Just the transaction fee! Currently, you can set this as low as 1 Nxt. Be aware, however, that if multiple accounts request the same alias at the same time, the request with the highest specified fee will "win".

How do I know my alias has been created?

Like any other transaction in Nxt, you should wait to see that your transaction is confirmed. Your alias creation transaction will appear in your "transactions" window as a transaction involving a transfer of 0 Nxt.

Can an account have more than one alias linked to it?

Yes. You can link an unlimited number of aliases to your account.

Can I give an alias to someone else once it's been created?

The account that creates an alias "owns" it. Currently, the owner of an alias cannot be changed.

What can I alias?

Almost anything! Web links, phone numbers, email addresses, Nxt account numbers – almost any piece of text!

How do I change an alias?

As long as your account is the owner of an alias, you can change the target/URI for the alias you registered by sending another transaction. Just choose a new target/URI for an alias that you've already created, and the network will change the URI from the old alias to the new one. The change will cost you a transaction fee.

Are aliases case-sensitive?


Are any aliases reserved?

Not at all. All aliases are assigned on a first-come, first-served basis.

The Arbitrary Messages System

see Arbitrary Messages and How to sendMessage

Advanced: Hallmarks

What is a hallmark?

Simply put, a hallmark is a digital signature that "certifies" that a node, running on a specific IP address, belongs to an account. A hallmark helps the network put trust into specific Nxt nodes, relying on them more than other nodes for accurate information on blocks and transactions. Anyone can decode a node's hallmark to verify its authenticity and ownership. If you run multiple nodes, a hallmark also allows you to set a relative "weight" for each node, so that the network can allocate more traffic to nodes that have more resources.

If my node is hallmarked, do I get benefits for forging?

No. Hallmarks have nothing to do with forging.

Should I create a hallmark for myself?

If you are a casual user of Nxt, running the software on a home computer that is not always on or publicly accessible on the Internet, you probably do not need to generate a hallmark. If you are operating a public Nxt node (or multiple nodes!) and have a non-trivial balance of Nxt, however, hallmarking is strongly recommended.

How do I create a hallmark?

See this How-To page for instructions.

How do I verify/check a hallmark?

Go to your Nxt software's admin page ( or http://localhost:7876/admin.html) and locate the "verify hallmark" section. Enter any node's hallmark text in the entry field and click submit. The server will return a JSON object that will tell you the following things associated with the hallmark:

  • Its IP address
  • The date it was created
  • The account that owns it
  • Whether or not the hallmark is valid

What is hallmark weight and how is it used?

The "weight" parameter for a hallmark is best-used when you are running more than one public node. You can generate many hallmarks tied to the same account, and the "weight" parameter is used to determine what portion of the account's balance should be credited to each node. Nodes with higher balances are more "trusted". The portion of the balance used to calculate weight is governed by the formula (weight/Sum_of_all_weights). For example, if you have three hallmarked nodes and set the weight parameter for each node to 100, the nodes will be weighted equally. If you have three hallmarked nodes and set the weights to 100, 200, and 300, the nodes will be weighted at (100/600), (200/600), and (300/600).

If my account balance changes, do I need to regenerate my hallmark?


Since account balance is used to determine weight, does this mean the weight of the hallmark affects forging?

No. Forging and hallmarks are unrelated. Hallmarked nodes do not forge any differently than non-hallmarked nodes.

From here, you may want to learn more about the Nxt client or look at common problems and resolutions!