Faq

From ArdorDocs
Revision as of 14:40, 13 November 2020 by Almonte (talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search
Other languages:
English • ‎한국어

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 that 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


How to announce my public key

When sending ARDR, child chain tokens such as IGNIS or any other token to a new account using the new account's address the resulting account is protected only by 64 bit account id, which is somewhat not as secured as the 256 public key which provides ultimate protection.

The risk is that someone can brute force a passphrase that maps into the same account id so that both accounts are indistinguishable so that the attacker can spend the funds in this address.

More specifically, the reason why this one-time extra step is necessary is because the 8-byte account ID is much shorter than the 32-byte public key it is derived from. There are many secret passphrase/public key pairs that reduce to the same account ID (2^192 keys). But once a particular public key is associated with an account ID by storing it in the blockchain, no other secret passphrase that generates a different public key can access that account.

To protect against this a simple step has to be taken to record the account public key in the blockchain. Recording the public key in the blockchain protects against the attack described above. The options to announce a public key is as follows:

Option 1: Submit an outgoing transaction from the new account

Any type of outgoing transaction will do since the user is signing this transaction with his passphrase and by doing so records the public key in the blockchain. This transaction can for example be sending ARDR, IGNIS, sending a message, creating an alias, and so on.

Note: your account must contain enough tokens (either ARDR or child chain tokens such as IGNIS) to pay the transaction fee, so you have to fund it with some tokens first.

Option 2: Another account can announce the public key of the new account to the blockchain

Any type of transaction in which the recipient is the new account will do. The sender needs to specify the new account public key as the "recipientPublicKey" parameter for the transaction API or using the wallet "Recipient Public Key" field. Most exchanges which support ARDR or Ardor child chain tokens, already supports this public key announcement function. This procedure is also suitable for companies that want to announce the public keys of their user accounts, hence the blockchain integration in the current business processes is smoother and seamless.


Faq.public.key.announcement.png


To find your account public key, simply login to your account using your passphrase (not using your Ardor address). If the account is not registered on the blockchain yet, the public key will be displayed on the dashboard.

For registered accounts, you can find the public key by clicking on the "Account Balance" tile from the dashboard


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 subdirectory 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 deployed the ChildToParentExchange lightweight contract at the account ARDOR-FGET-YXM3-USHQ-2SPC9 (alias: @IgnisToArdor).

The steps to trigger the contract are as follows:

1: Launch the Ardor User Interface, select the IGNIS chain and click on the button 'Send IGNIS'

2: The IGNIS amount must be sufficient to pay the 1 ARDR transaction to receive the ARDR funds, the contract will automatically send back ARDR based on the market rate. Enter as recipient the values ARDOR-FGET-YXM3-USHQ-2SPC9 or the alias @IgnisToArdor:

@IgnisToArdor

3: The Contract Reference selector box is now populated, select the contract 'ChildToParentExchange' as shown in the image above. Click on the 'Add a message' box, add either to encrypt the message or not, calculate the fee and send the transaction.

@IgnisToArdor

4: Once the transaction is confirmed, switch to the parent chain Ardor:

Switching to Ardor

5: In the Section 'Recent Transactions' it will be shown the transaction from the @IgnisToArdor account to your account:

@IgnisToArdor Transaction back


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 a large stake from predicting their forging time and forge their own transactions and thus pay the transaction fees to themselves


Ardor Fee Structures

A small fee is required for every transaction, including those in which no ARDR is transferred, such as simple messages when using a child chain. The Ardor fee structures are as follows:

Download Ardor Fee Structures

Transaction Fee (ARDR) Reasons
Default Ardor fee 1 permanent transaction
Default Child Chain fee 0.01 prunable transaction
New account fee 1 creates permanent global entity
Balance leasing 0.1 Ardor chain only, not frequently used
Ardor Coin Exchange 0.5 permanent transaction
Asset issuance 100 create permanent global entity, Ignis chain only, not frequently used, need to reduce scam assets
Singleton asset issuance 1 + 1 per 32b Ignis chain only, more frequently used, but still creates global permanent entity
Asset increase 10 Ignis chain only, rarely used
Dividend payment 0.1 needs processing, not frequently used
Set asset control 10 Ignis chain only, not frequently used, asset issuers only
Set account control 1 Ignis chain only, not frequently used
Cloud data upload 0.1 + 0.01 per 1kb prunable, but takes space
Poll creation 1 + 0.1 per option > 20 + 0.2 per 32b > 288b not frequently used, need to keep until the poll is over, takes space
Phasing approval 0.01 per approved tx needs processing
Account info 1 + 1 per 32b permanent, Ignis only, rarely used
Set account property 0.1 + 0.1 per 32b permanent, Ignis only, not frequently used
Alias assignment 1 + 1 per 32b creates permanent unique entity, not frequently used
Shuffling (total) 0.12 takes space, but prunable, not frequently used
Shuffling penalty 10 IGNIS, 10 Bitswift must be affordable, but not negligible
Currency issuance 4 / 100 / 2500 creates permanent unique entity, not frequently used
Marketplace listing 0.2 + 0.2 per 32b takes space, need to keep until delisting, not frequently used
Marketplace delivery 0.1 + 0.2 per 32b takes space, need to keep
Permanent message 0.1 + 0.1 per 32b permanent
Prunable message 0.01 per 1k prunable
Phasing appendix 0.01 balance independent, 0.2 balance dependent + 0.01 per 32b size depends on size and complexity, needs processing
Composite phasing appendix 0.02 + 0.02 per 32b + per poll fees determined by phasing complexity
Referenced Tx deposit 10 refundable


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: Note: You may need to install gpg from GNUPG.org.

  1. Point your web browser at https://www.jelurida.com/ardor/downloads
  2. In this web, you will see the latest Android software in file, along with a corresponding .ASC file. The ZIP file contains the Nxt software, and the ASC file contains the GPG signature.
  3. Download both the clint ZIP file and its corresponding ASC file, and place them into the same directory on your system
  4. Execute the following command

    gpg --verify SIGFILE.asc

    ...where SIGFILE is the name of the ASC file

Execute the following command

gpg --verify SIGFILE.asc

...where SIGFILE is the name of the ASC file published on https://www.jelurida.com/ardor-android.apk.asc


Dealing with Passphrase Problems

Due to the decentralized design of the blockchain, the user is the only one who received the secret passphrase during the 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 recommends 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 that 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 a 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 its operation. Some of these nodes are not up to date and include the 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 the 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.


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 one for Android, refer to Android Full Node

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


How do I get ARDOR/IGNIS?

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


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

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 a reference to see the existing properties and their documentation.

Never modify the nxt-default.properties file since your modifications will be overwritten by an 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.

How to open the API access of your node from remote client

Add the following lines to nxt.properties:

nxt.apiServerHost=0.0.0.0 

nxt.allowedBotHosts=*

and restart the node for the properties to take effect.

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 that 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 the 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 especially 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 centralized exchanges