Faq

From ArdorDocs
Jump to: navigation, search

Contents

What is Ardor?

Ardor is an evolution of the Nxt software that addresses issues of blockchain bloat, scalability, and versatility. Its turn-key functionality allows new blockchain applications to be built and launched without the need for extensive custom code or architecture.


What is Jelurida?

Jelurida BV is the name of the company who owns the Nxt and Ardor blockchain platforms. It was created in 2016 and provides blockchain-as-a-service solutions to other companies and organizations.


Where do I get started?

Please, see Getting started on this wiki.


What is my public key

Our public key is not your passphrase Your public key is not your account In most cases you don't need to worry about your public key at all.

However, for a new account which never made any outgoing transactions you can find the public key when you login using your passphrase (not using your account id) It will be displayed on the dashboard as a 64 characters long stream of hexadecimal characters:

Faq.public.key.png


Install Ardor on Windows 7 32 bit

Install Oracle Java 8 32 bit From the command line, in folder "c:\program files\ardor" or the previously folder selected during the installation run the following command:

java -cp classes;lib\*;conf;addons\classes;addons\lib\* -Dnxt.runtime.mode=desktop nxt.Nxt

For instance:

"C:\Program Files (x86)\Java\jre1.8.0_172\bin\java.exe" -cp classes;lib\*;conf;addons\classes;addons\lib\* -Dnxt.runtime.mode=desktop nxt.Nxt


Where to find the node log file?

ardor.log is our main diagnostic resource for diagnosing node related problems such as startup issues, blockchain download and contract execution.

To locate this file, first find your Ardor user directory. The log files are located in the logs sub directory where you will find the ardor.log file. There are multiple revisions of this file named ardor.0.log, ..., ardor.9.log.

In most cases, ardor.0.log represents the existing node log file.

Exchange IGNIS to ARDR transaction returns "not enough funds"

Coin exchange transactions from any child chain to the Ardor parent chain are recorded on the parent chain since it affect the ARDR balances and therefore pay fee in ARDR. Therefore exchanging IGNIS to ARDR using the coin exchange is impossible unless you already have ARDR to pay for the transaction fee.

As a temporary solution to enable users to exchange child chain coins to Ardor even if they do not already own ARDR, Jelurida has setup a faucet account ARDOR-VEUQ-JZN2-22T9-4QKWV Send 10 IGNIS to this account to receive back 4 ARDR Send 2 AEUR to receive 4 ARDR

  • Might be updated in case exchange rates change significantly
  • Exchanges will be performed within 24 hours
  • Don't send any other amounts or tokens to this account


Ardor block rewards

When forging a block in Ardor all transaction fees from the included transactions are rewarded to the forger account except block rewards from transactions of type Child Chain Block which are split between forgers of the last 4 blocks 25% each.

The reason it's implemented this way is to prevent forgers with large stake from predicting their forging time and forge their own transactions and thus pay the transaction fees to themselves


What is the testnet

When we develop our blockchain products Nxt and Ardor we need to perform testing. For this purpose, we keep another blockchain instance we call Testnet which is similar in functionality to the actual production blockchain also known as Mainnet but uses a worthless token.

When you connect to the testnet you see a Red message saying "You are connected to the TestNet!" This means that any information you see in the wallet is just test data and does not represent any official amount. Use this blockchain only for testing.

To turn on testnet add the following property to your nxt.properties file nxt.isTestnet=true and restart your node. To connect to mainnet remove this property or set it to false.


How to verify authenticity of Ardor installations

Windows exe: Right click, Properties, Digital Signatures Tab, Name of Signer should be "Jelurida Swiss SA"

Mac DMG file: 1. Open the DMG file to create the Ardor Installer application 2. From the command like issue the following command:

codesign --verify -v /Applications/ardor-installer.app

The output should be: valid on disk For more a verbose output use:

codesign -dv --verbose=4 /Applications/ardor-installer.app

Linux .sh and .zip files

sha256sum <file name>

The result should match the sha256 hash published on https://ardorforum.org/ by account Jelurida

Android mobile app:

sha256sum <file name>

The result should match the sha256 hash published on https://ardorforum.org/ by account Riker


Dealing with Passphrase Problems

Due to the decentralized design of the blockchain, the user is the only one who received the secret passphrase during creation of a new Ardor account with the default Ardor client. There is no way for anyone to restore or reset the passphrase, not even for the developers. So if the passphrase is lost, it is impossible to make transactions from the account.

Every combination of characters opens a different Ardor account. So if you mistakenly add an extra space at the end of your passphrase, or make a small typo, you will open a different Ardor account.

The default Ardor passphrase consists of 12 random English words out of a 1600+ words dictionary. This is impossible to crack by brute forcing. Only if you think you made a small typo, or if you forgot for example 1 of the 12 words, it might be possible to find the correct passphrase by brute forcing it. Some community members made tools for this, for example https://ardor.tools/typo/typo.html (which needs the public key) and Ardor itself provides a basic password recovery tool Passphrase_Recovery. You can also ask for help in ardorforum.org or the Ardor Slack chat.

If your passphrase and the account that has your ARDR don't match, you are either using the wrong password, or you sent your ARDR to the wrong account by mistake, thinking it was your account.

For example: You create the account, and passphrase A is shown on screen. You enter it in the client the first time, but you unfortunately make a small typo, so you end up in account B. Every combination of chars opens a new (empty) account. You think passphrase A matches account B, so you send your tokens to account B. Now when you enter your passphrase for A without the typo, it doesn't work for account B. When you login with passphrase A, you end up in the real account A, which has 0 ARDR in it. You could try to find out what password B (with the typo) is, that gets you to account B with the ARDR in it, but you'll have to be lucky to find the typo.

The best way to prevent this, is to always REALLY make sure you REALLY control your account that has the passphrase. Just send 1 small outgoing transaction from the account before you even put large amounts of funds in it. By the way, the client DOES strongly recommend you to do an outgoing transaction in order to publish your public key to the blockchain for new accounts.


User directories per product and platform

Default user directory: Ardor on Windows: C:\Users\<username>\AppData\Roaming\ardor

Ardor on MAC: ~/.ardor

Linux: Ardor folder where the installation package was unzipped

If you are not sure, look for the ardor.{n}.log where {n} is the log file number. The current log file is always named ardor.0.log. Up to 10 log files are kept. These files exist under the user's logs directory.


What is my Ardor account address?

Your Ardor account address is the string displayed in the upper left corner of the wallet with the format ARDOR-XXXX-XXXX-XXXX-XXXXX Is something else my address? No this is your address, don't use anything else as your address. Your passphrase is not your address, never reveal it to anyone, don't even post it in a support ticket unless the account is empty. Your public key composed of 64 hexadecimal characters, it is not your address. Only provide it when someone is asking you specifically to provide your public key. In addition, remote nodes may use administrator password, this is not your account address, not your public key, and not your passphrase and of course you should not reveal it to anyone.


It is impossible to reset your passphrase

Blockchain is designed to be completely decentralized, therefore it is technically impossible to reset your passphrase or retrieve it. The user is the only one who has the passphrase. There is no central authority which controls your funds, like in the traditional banking system. Not even the developers can reset your passphrase.

The only way to submit transactions from an account on the blockchain is to use the original passphrase (from which the cryptographic private/public key pair is derived).


Changelly issues

The Ardor wallet includes pages which integrate with Changelly. In addition when funding your account for the first time the wallet will use the Shapeshift widget to exchange tokens.

However, the wallet uses the exchange APIs while the actual exchange is performed using Shapeshift or Changelly, therefore if something went wrong, please open support ticket for the relevant exchange and provide all the relevant information. From our experience they resolve tickets relatively quickly and efficiently and in most cases will simply refund your deposit to a refund address you'll provide.

Typical reasons for problems include: 1. Waiting too much time between getting the deposit address and making the deposit. This process has to complete within 5-10 minutes or else the exchange will cancel the offer and your deposit will never be exchanged. 2. Sending a deposit amount which is smaller than the minimum


Why do I sometimes see 0 balance (Light Client mode)

After starting the Ardor client for the first time, the client needs to download a copy of the blockchain. This download process can take a while. During this time the client relies on random remote nodes for it's operation. Some of these nodes are not up to date and include old state of the blockchain. Therefore recent transactions are not reflected causing your balance to show 0.

There is nothing to worry about.

How to fix the problem? Any of the methods below will do 1. Restart your node to allow it pick another remote node 2. Download local copy of the Blockchain 3. Check your balance on a block explorer


Exchange deposit problems

If you sent your ARDR or IGNIS to an exchange and it did not arrive you should check with the exchange what happened. Some exchanges manage all their tokens in a single account and identify user deposits based on message text they provide and should be attached as a message to the deposit transaction.

There are several ways to get your funds locked because of this: 1. Failing to send this requested message when submitting the transaction from the wallet, will surely get your funds locked and requires contacting the exchange customer support and you should expect a long delay until getting a refund. 2. Sending an encrypted message when the exchange asks for plain text one or vice versa is another popular way to lock your funds. If the exchange does not specify otherwise we recommend that you send the message as plain text. 3. Sending ARDR/IGNIS, from one exchange to the other will get your funds locked since there will be no message attachment.

Another common deposit issue is with sending a very small amount, which is not economical for the exchange to deal with. It's not simple to tell what is this minimum amount and it changes between exchanges.

Sorry, but there is nothing we can do to help with these issues since these are restrictions related to inner working of exchanges


Exchange Withdrawal Problems

When withdrawing your funds from an exchange always make sure to provide your account address and make sure you have a passphrase. Providing an incorrect account address or an account address to which you don't have the passphrase is a sure way to lock your funds forever. Writing the amount in the account address field or any other irrelevant info is another popular way to lock your funds forever, since some exchanges do not validate the account address before withdrawal. If the exchange also asks for a public key, login using your passphrase and retrieve the 64 character long account public key.


What is Forging?

Forging is the process of generating new Nxt and Ardor blocks. A block is a container of 0 or more transactions, blocks are generated every 1 minute on average. The forger of the next block receives the transaction fees for this block.

Q: Who can forge new blocks? A: Any account with a balance of more than 1000 ARDR vested over 1440 blocks (approx. 24 hours).

Q: Why is my wallet showing "Not Forging" indicator? A: Because you are not forging, either because your balance is insufficient or because you did not start forging since your last node restart.

Q: Should I use an account with a lot of ARDR for forging? A: No, you should lease your balance to another account and forge with the other account see Account leasing.


Cannot submit transactions while using light client in Ardor

This is a known problem we are looking to fix in one of the next releases. The transaction appears to be submitted but is not being broadcast to the network. No funds are lost or affected.

This problem affects two configurations: 1. Light client which does not download the blockchain 2. Roaming client which works as light client during blockchain download

Workaround: Switch to full client

Option 1: Reinstall Ardor without checking the light client option during installation Option 2: Add the following line to conf/nxt.properties under User directories per product and platform nxt.isLightClient=false

In both cases you'll need to restart your node and wait for the blockchain to finish downloading.


How to download a copy of the blockchain

By default, when installing the Ardor software as a 'full client' the local wallet automatically finds other remote peers and starts the blockchain download. This process is very secure, since your node re-validates all the transactions during the download.

However, on slow hardware or limited internet connection this process can be very time consuming and could take several hours (Ardor). If you are in a hurry, and trust Jelurida to provide a good copy of the blockchain, you can go to the Jelurida homepage www.jelurida.com and download a copy of the blockchain database.

There are several options: Ardor production - is the Ardor mainnet blockchain Ardor testnet - is the Ardor testnet database used for development and testing (doesn't contain real transactions)

On Windows (when using Ardor mainnet) the blockchain will be downloaded to your "C:\Users\USERNAME\AppData\Roaming\ardor\nxt_db" folder. Make sure that you can see hidden folders. You can find your AppData folder very quickly by entering "%appdata%" in the address bar of the file explorer. Shutdown your Ardor client (using the Ardor icon in your Windows system tray), and place the nxt_db folder into your "C:\Users\USERNAME\AppData\Roaming\ardor" folder. Start the Ardor client again and the download should be up-to-date quickly.

On MacOS (when using Ardor mainnet) your default user directory is ~/.ardor for Ardor


Ardor Scaling Parameters and Constants

As of version 2.0.12 Parent block time: 1 minute on average Parent transactions per block: 10 ChildChainBlock transaction per chain per block: 1 Child chain transactions per ChildChainBlock transaction on the parent chain: 100 ChildChainBlock transaction pay load size: 128K Epoch beginning mainnet: 2018-01-01 00:00:00 UTC Epoch beginning testnet: 2017-12-26 14:00:00 UTC

For other constants and limits, see


What wallet/client should I use?

We recommend using the Ardor client, which you can download from Jelurida's Bitbucket.


How to check your IGNIS balance

To check your IGNIS balance: 1. Install Ardor from jelurida.com (See Ardor Downloads). 2. Run Ardor and wait for the blockchain to download. 3. Login using your Ardor account. 4. Switch to the IGNIS chain to check your IGNIS balance.

Faq.switch.chain.png


Is there a mobile wallet?

There is an Ardor Lite version in the Google play. Click on install with your Android devide and follow the instructions.

Also, starting from release 1.11.0e in the previous Nxt client was also released as a mobile app for Android. The mobile app is based on the existing web wallet packaged as an Apache Cordova application. No iOS wallets at the moment.


How do I get ARDOR/IGNIS?

Here's places where you can get ARDR and/or IGNIS with EUR, USDT, BTC and other currencies.

  • Ardorgate
  • Bittrex (BTC)
  • Poloniex (BTC, USDT, XMR)
  • HitBTC
  • Binance
  • Huobi


Node configuration using the nxt.properties

The configuration of your Ardor node is configured using properties set in the nxt.properties file.

The nxt.properties file is a text file which can be created using any text editor (notepad on Windows and vi on Linux and Mac will do) Create or update the nxt.properties file in the conf directory under the user directory

For example, to open API access to your node from remote client, add the following lines to nxt.properties:

nxt.apiServerHost=0.0.0.0

nxt.allowedBotHosts=*

Every change to properties will only take effect after you restart your node.

You can use the nxt-default.properties file from the conf directory of the Ardor or Nxt installation as reference to see the existing properties and their documentation.

Never modify the nxt-default.properties file since your modifications will be overwritten by any upgrade to a new version.

Another configuration file you should never modify is nxt-installer.properties. This file stores the configuration selected during the installation.

Any setting set in nxt.properties will override settings in nxt-default.properties and nxt-installer.properties

For advanced users:

The location from which the property files are loaded can be customized using a Java command line argument named according to the property file name. For example:

java ... -Dnxt.properties=./conf/examples/testnet.properties ...

Will tell the Ardor node to load the nxt.properties file from the ./conf/examples/testnet.properties folder.


What is the admin password?

The admin password is not your passphrase, not your account id, and your public key, it is something else, read on. When connecting to a remote node using the API there are certain operations which are restricted by default unless the adminPassword parameter contains a value matching the remote node admin password is specified in the API call.

You setup the admin password in the remote node in the nxt.properties file:

  1. Password that should be provided when executing protected (administrative) API requests.
  2. Please choose a decent password here. Preferably, use a password generator.
  3. Password protection is disabled and password is not needed when the API server only listens on the localhost interface, i.e. when nxt.apiServerHost=127.0.0.1.

nxt.adminPassword=

The same value specified in nxt.adminPassword should be passed when calling any API which accepts adminPassword as parameter. When loading the wallet from a remote node enter this value in the account settings page "Administrator Password" field.

The admin password is required for the following operations (partial list) 1. For any query API such as getBlockchainTransactions to return more than 100 records 2. get and stop APIs for forging, bundling, funding monitor and shuffler 3. Access to the /dbshell page in order to execute SQL queries 4. Various administrative APIs

API response errors and their meaning: "Administrator's password is not configured. Please set nxt.adminPassword" - you need to configure the admin password on the remote node. "adminPassword not specified" - password is configured on the remote node but is not specified by the API call "Incorrect adminPassword (the specified password does not match nxt.adminPassword)" - the password specified did not match the remote node password "Too many incorrect admin password attempts from ..." - you specified too many incorrect password attempts


What is the roadmap of Ardor?

Jelurida maintains a public Ardor roadmap and have a good track record sticking to it.


Where can I find more detailed information about Ardor and its features?

You can read all the material in the Features and Tutorials section. By then you should have a pretty good foundation to dab into the API.


Where do I find news about Ardor?


Where do I find information about the API?

Please see the API section on this site.


What features does Ardor have?

Ardor functionality is restricted to maintain the PoS algorithm. Ignis has numerous core-level features such as the ability to issue assets, a decentralized asset exchange, decentralized voting, coin shuffling (for anonymity), alias system, decentralized marketplace, multisig capabilities, and a monetary system for currencies. For more information you can read the Features section of this site.


How many nodes are up for Ardor?

PeerExplorer is a great tool to see live information about nodes.


Where is the source code?

You can find the source code in Jelurida's Bitbucket.


Does Ardor have a testnet?

Yes, you can access Ardor's testnet here.


How do I access my Ardor account on the Ardor client/wallet?

Download the client and introduce your passphrase


Why am I getting a Java error when I try to start the software?

Ardor relies on Java 8. Make sure you download and install latest version installed from Oracle! You can check to see which version of Java is running on your computer by running the following command in a terminal window:

java -version


Why cannot I open the client in a web browser?

First of all, you need to make sure that the Ardor server window has finished loading, as indicated by a message like this:

Ardor Server vx.xx.xx started successfully. To access your client interface, you can then use either of these addresses:

http://localhost:27876/ http://127.0.0.1:27876/


Why doesn't my blockchain finish loading?

Patience is usually the best fix; your client will eventually catch up with the network. Some delay may occur specially when you have updated to a new software version that performs a database upgrade. If you are in a hurry you can download a recent copy of the blockchain from the Jelurida web site.


Why do my blockchain files keep getting corrupted?

The blockchain database may get corrupted as a result of the Ardor software being forcefully terminated in a way that doesn't allow the server to close the database properly. You should be able to see "Database shutdown completed" in the log before shutdown as a sign that data files have been properly closed. To prevent data corruption when closing Ardor:

In Windows, use Ctrl-C to shut down the process in the terminal window In UNIX, use kill -15 #ID PROCESS do not use kill -9 #ID PROCESS.


I keep accessing a different account number than the one I created. What's going on?

Since different account numbers are accessed using different passphrases, getting a different account number than the one you expected means you used a different passphrase than the one originally used to generate your account number. Make sure you are introducing your original passphrase correctly. This means double-checking for typing mistakes, and ensuring no extra spaces are accidentally pasted (or omitted!) in the beginning or the end of your passphrase as you paste it to unlock your account.


Does Jelurida still maintain Nxt?

Yes, Jelurida will continue to support and develop both Ardor and Nxt. A portion of the funds from the Ignis token sale was reserved towards Nxt development as explained in the Whitepaper.


How can I buy IGNIS?

You can buy IGNIS using the Ardor coin exchange feature or with the following centralised exchanges:

  • Upbit
  • Indodax
  • Bittrex
  • HitBTC
  • STEX