- 5 November 2019 Lightweight ContractsMore elaborated explanation about bundler filtering properties
- 4 November 2019 Messages
- 15 October 2019 Android Full NodeAdded Android Full Node guideline
- 8 October 2019 Basic tutorials/enUpdating to match new version of source page
- 3 October 2019 Basic tutorials/koUpdating to match new version of source page
Ardor is a blockchain-as-a-service multi-chain platform that evolved from the time-tested and energy efficient Nxt blockchain. The Ardor mainnet launched on 01 January 2018. Through this documentation, you will learn all about the extensive capabilities of the Ardor platform. Begin developing your knowledge by reading about each of Ardor’s distinctive Features or consider trying the technology yourself by following some Basic Tutorials. For developers, documentation is provided for each of Ardor’s more than 250 APIs that can be used to quickly and cost-effectively deploy dApps and smart contracts that integrate your business processes with the Ardor blockchain. Check this site regularly for new content and updates as additional features are released.
Ardor Fee Structures
|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 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|
Before we begin, if you haven’t already done so, you may wish to check that you have the correct (usually most recent) version of Java installed on your computer. You can use any compatible Java available for your platform. The minimum required version is Java 8. The recommended version is Java 11. We usually test with OpenJDK 11.
To start with Ardor/Ignis, you must first download the client, also known as a "wallet", on your machine. The client is distributed as a binary package for the following platforms:
- Download the Windows installer for the latest official Ardor Client 2.2.6 from https://www.jelurida.com/ardor-client.exe. If you want to test our newest features, such as lightweight contracts, you must select the testnet option during the installation process.
- Ardor's Windows client comes as an .exe file. After downloading it, you can verify its integrity by performing an integrity check
- Run the installer and follow the instructions on screen. Note that you can select either the testnet or mainnet during installation, if further details are needed please follow the step-by-step guide. Once installed icons will be created by default in your desktop and Start Menu.
- You can now run the Ardor software by clicking on the Ardor icon. After a few seconds, the Ardor wallet will open in its own window.
- If you already have created a Ardor account, click in 'Returning User' to introduce your passphrase. If you need to create your Ardor account, click here for instructions to Create a New Ardor Account.
- Download the Mac installer for the latest official Ardor Client 2.2.6 from https://www.jelurida.com/ardor-installer.dmg. After downloading, verify its signature. If you want to test our newest features, such as lightweight contracts, you must select the testnet option during the installation process. After downloading, check the SHA256 hash of the package for security.
- Run the installer package (Ardor's Mac installer comes packaged in .dmg format) and follow the instructions on screen
- Click on the ardor-installer.app
- A security warning appears, click on the icon "?" highlighted in green
- Click on the "Open the General pane for me" in the pop-up that appears
- Click on the lock highlighted in green to make changes
- The option "Open anyway" is now available. Click on this button (note: if it does not appear please close temporary the Ardor installation windows)
- Now open the ardor-installer.app and click on the "Open" button
- Select the language
- Click on 'Next' to begin with the installation
- Accept the terms of the license agreement
- Select the installation path
- Select the packages you want to install
- Check the options See the tutorial for setting up the Ardor testnet
- Once installed, click on finish
- You can now run the Ardor software clicking on the "ardor.app" in Applications. If you already have created a Ardor account, click in 'Returning User' to introduce your passphrase. If you need to create your Ardor account, click here for instructions to Create a New Ardor Account.
Here is the guide to installing the Ardor Client on a Linux 64-bit platform. 32-bit installation instructions are very similar; you just might need to download the 32-bit version of Java instead of the 64-bit one.
You can use this instructions on your Linux VPS as well.
Set up Java
You can skip this step if you already have Java installed. Otherwise, you can install it via your distribution repository doing the following (for Ubuntu/Debian builds):
sudo apt update sudo apt install openjdk-11-jre-headless
You can also use `openjdk-8-jre-headless` or any other Java 8+ compatible version.
Install and run the Ardor Client
Using the Unix installer
You can execute the unix installer executable compatible with most linux distributions from ardor-client.sh and follow the instructions.
wget https://www.jelurida.com/ardor-client.sh sh ardor-client.sh
Using the Universal Zip Package
You can follow the more generic instructions as explained below:
- Change to your home folder and download the latest client (version 2.2.6):
wget https://www.jelurida.com/ardor-client.zip.ascand verify that the signature is correct:
gpg --with-fingerprint ardor-client.zip.asc. If you want to test our newest features, such as lightweight contracts, you must select the testnet option during the installation process.
- Unzip it:
Run the Ardor client
- Now it's time to start the software. You may start it by executing
nohup ./run.sh &for running the Ardor node in the background, which you will find in the ardor directory. The server will be active as soon as you see in the window a text similar to this:
Ardor server 2.2.6 started successfully.This shell window will be running the Ardor server and print all the Ardor log messages, so it needs to stay running!
- Open http://localhost:27876/ from a web browser to access the Ardor Client. Please note that, if it's the first time you run Ardor in your machine, the Ardor blockchain will need to be downloaded until it is up to date. Depending on the your network connection speed, this may take a few hours. The Ardor Client will show you a progress bar as the blockchain downloads. Now you can visit the click here for instructions to Create a New Ardor Account.
- NOTE: If you've installed the client on a dedicated server or VPS, you should change "localhost" to your Server/VPS IP.
For installing the Ardor client on a Raspberry pi, you can refer to the description of an implementation with the Ardor client powered by solar panels
Need help during the download or development process? Contact us on the slack #helpdesk channel, chat with community experts on the Ardor Forum, and take a look at the FAQ. You can also reach us opening a ticket in our helpdesk
Getting your first ARDR
With the Ardor client installed, it is now time to start transacting. To do that, we need to get some tokens, be it ARDR, IGNIS, or any other childchain. The Ardor mainnet is live and actual tokens are in circulation across numerous major exchanges.
Note the tokens we will be using in the next examples are from testnet. These tokens are not traded in exchanges and have no monetary value -- they exist only as a convenience for developers and those willing to experiment with the features.
Feedback and errors
If an error in this documentation is found, we would love to be aware to correct it as soon as possible. Please write a question to the stackexchange and we will take care.