About Qora
Qora is a community-based cryptocurrency network. The emphasis is on community services like blogs, websites, etc. based on blockchain technology.
Source Code
Qora source code is hosted by
External Resources
Take a look at the
Getting Started
Installation
Windows Wallet
Download the latest Windows installer from github:
Run the installer and follow the instructions.
If installation is successful then you should have a Qora desktop icon and entries in your Windows menu.
Universal Wallet
Make sure you have at least Java v8 installed. or
Download the latest Qora Zipfile from github:
Once the file is downloaded, unzip it and it will make a Qora folder. You can move the Qora folder to wherever you like i.e. desktop, home directory etc.
Inside the Qora folder there will be a run.sh file you can double-click. Make sure you have the right permissions set to execute the file, right click on run.sh, choose "Properties" from the menu, go to the "Permissions" tab, in the "Execute" field make sure it reads "Only owner and group" and apply changes if needed.
Alternatively you can open a command prompt or shell window, change directory to the Qora folder and type:
./run.sh
Settings
Basic
- GUI Enabled
Most users will leave this enabled so they can access their wallets. Only people running a headless, high-availability node might consider disabling the GUI.
- RPC Enabled
- RPC port
Enabling RPC allows your Qora client to process API calls via the specified port using HTTP. Some of the built-in web pages use API calls, e.g. block explorer, name storage, anything wallet-related. For these to work you need to have RPC enabled. To restrict API callers, take a look at Access Permissions.
- WEB Enabled
- WEB port
Enabling WEB allows you to access the Qora network/blockchain/features using your web browser, which might be easier and more feature-rich than the Qora client's GUI. To restrict access, take a look at Access Permissions.
Known Peers
This is a list of peer IP addresses known to your Qora client, along with a tick-box to show if you're connected to them. You can add new peer IP addresses using the input box below then clicking "Add". To remove an address, right-click on the address and select "Delete address".
Access Permission
These are two lists of IP addresses that can connect to the RPC and WEB ports of your Qora client (if enabled). You can add IP addresses using the input box below then clicking "Add". To remove an address, right-click on the address and select "Delete address".
settings.json
When you click "Apply" your settings.json file will be rewritten to reflect the new settings.
Wallet
Start the application
Create a Wallet
Recover wallet from seed
Lock your wallet
Unlock your wallet
Accounts
Create account
Delete account
Import account from seed
Seed
Retrieve wallet's seed
To retrieve the seed of your wallet you first need to have your wallet unlocked in order to be able to get the seed.
Open the console and type the below command :
GET wallet/seed
The above command will return the 32-byte long base58-encoded wallet seed.
You can also made the above API request by simply visiting the below URL while RCP is enabled.
HTTP Request
If you have encountered an error while making the above request, the exact error code will be displayed.Below is the errors list.
ERRORS
| Error | Description |
|---|---|
| 201 | Wallet does not exist. |
| 203 | Wallet is locked. |
Retrieve account's seed
You can retrieve the seed of a specific address that exists in your wallet.
To retrieve the seed of your addres you first need to have your wallet unlocked in order to be able to get the seed.
Open the console and type the below command :
GET addresses/seed/{address}
The above command will return the 32-byte long base58-encoded seed of the given address.
You can also made the above API request by simply visiting the below URL while RCP is enabled.
HTTP Request
If you have encountered an error while making the above request, the exact error code will be displayed.Below is the errors list.
ERRORS
| Error | Description |
|---|---|
| 102 | Invalid address. |
| 201 | Wallet does not exist. |
| 202 | Address does not exist in wallet. |
| 203 | Wallet is locked. |
Generate a seed
You can generate a random base58 encoded seed with a simple API request.
Open the console and type the below command :
GET seed
The above command will return a base58 encoded random seed of 32 bytes.These seeds can be used to create a wallet or to import an account.
Use the optional parameter length to request a seed of {length} bytes.
GET seed/{length}
You can also made the above API request by simply visiting the below URL while RCP is enabled.
HTTP Request
Payments
Send Payment
Send Name Payment
Send payment within a message
Send multi payment
Messages
Send message
Encrypt message
Decrypt message
Sign a message
Verify message
Naming service
Register a name
- Using your Qora client, first click on the "Naming Service" tab.
- Next click on "Register" button. This should open a new window.
- Select the Qora account that should own, and pay for, your new name from the drop-down list.
- Type in your chosen name in the "Name" box. As you type the "Name Details" box below will inform you if your name has already been taken or not.
- For first time use, you can ignore the "Key" and "Value" fields - or delete the "defaultkey" that is made for you using the "Remove" button.
- Click the "Register" button and your name registration request transaction will be submitted to the Qora network for confirmation.
You will know when your new name is ready to use when the "Confirmed" tick-box is ticked.
Update name
- Using your Qora client, first click on the "Naming Service" tab.
- Right-click on a name and select "Update" from the pop-up menu. This should open a new window.
- In this new window you can change the owner (make sure you get the address correct) or add/remove key-value pairs associated with the name using the "Add" and "Remove" buttons.
- To add a key-value pair, enter the key and value in the respective input boxes then click "Add"
- To remove a key-value pair, single-click the pair in the list to highlight it then click "Remove"
Note that altering the data storage associated with a name is done via
Transfer name
Exchange
Buy a name
Sell Name
Cancel sell name
Polls
Navigate
Vote
Create a poll
Assets
Navigate
View Asset details
Add to Favorites
Open Pair
Buy asset
Sell asset
Place a buy order
Cancel a buy order
Place a sell order
Cancel a sell order
Issue asset
Transfer asset
Send multi payment
Arbitrary Transactions
Arbitrary transactions is a Qora feature that allows storage on the blockchain.
The data of the arbitrary transaction must be base58 encoded and must be between 1-4000 bytes.
Send arbitrary transaction
To create an arbitrary transaction, open the console and then send your Command.
Below you will see an example command.
POST arbitrarytransacions {"creator": "QNbA69dbnmwqJHLQeS9v63hSLZXXGkmtC6", "data":"4GFHMAo9fmbUq7usopgntwUfAiLtpL98K6QCosAJsqQmY95tfd5KoUaKu34v6Qwp7RtYEhobCx7LVi7aYbbtpzfA","service": 555,"fee": "1.00001"}
Returns the transaction in JSON when successful.
If you have encountered an error while making the arbitrary transaction, console will display the error code. Below is the errors list.
ERRORS
| Error | Description |
|---|---|
| 1 | Json error. |
| 2 | Not enough balance. |
| 3 | Not yet released. |
| 102 | Invalid address. |
| 105 | Invalid fee. |
| 115 | Invalid data. |
| 116 | Invalid data length. |
| 201 | Wallet does not exist. |
| 202 | Address does not exist in wallet. |
| 203 | Wallet is locked. |
Load arbitrary transaction
To load an arbitrary transaction, open the console and then send your Command.
Below you will see an example command.
POST transactions/scan {"type":10,"creator":"QNbA69dbnmwqJHLQeS9v63hSLZXXGkmtC6"}
Returns all the arbitrary transactions made by the given creator.
Automated Transactions
Deploy AT
To deploy an AT (smart contract) go to the AT tab and click Deploy AT.
Enter the values accordingly on each field and click deploy.
Atomic Cross-Chain Transfers
Initiate ACCT
Response ACCT
Qora Web
Web Server
The built-in web server can be accessed by either:
- right-clicking on the Qora icon in your system tray and selecting "Qora Web/Social Network"
- from the "File" menu in your Qora client GUI select "Decentralized web server" (also via Alt-W)
Browse the web
You can view blockchain-stored websites by going to the .
Deploy a website
First of all, you'll need a registered name. If you don't have one already, please see Registering a name. To create/edit your name's website use the
- First pick which name's website you want to create/edit from the drop-down list.
- Make sure the "key" field is left blank (or explicitly use the key "website").
- Create/edit your website either using the "data" field and its built-in Visual Editor OR upload the data from a file on your computer using the "BROWSE" button. (This will overwrite the contents of the "data" field).
- Click "Submit" to submit your website to the Qora network for confirmation!
Note that the fee charged depends on how much data you store (i.e. the size of your website). Make sure you have enough balance!
Tools
Here you can find a list of tools
Block Explorer
is an online Qora block chain browser which displays the contents of individual blocks, transactions, transaction histories, balances of addresses, unconfirmed transactions, assets, polls and many statistics.It's written and operated by agran and it's the official Qora block explorer.
Blogging Service
Official blogging service of Qora has been created by agran. You can view the or find individual blogs using the . This service uses the arbitrary transactions feature of Qora to serve a socialized blogging suite. To create a new blog post click the new blog entry icon at the top of the .
Faucet
VanitygenQora
VanitygenQora is a command-line vanity Qora address generator created by agran.
You can find the latest version here :
HTML Editor
Multiple Pages Generator
Help
How To
Here you can find a quick How-To list
- How to install
- How to create a wallet
- How to send payment
- How to send message
- How to register a name
- How to vote
- How to buy an asset
- How to sell an asset
- How to issue an asset
- How to deploy an AT
- How to make an Atomic Cross-Chain transfer
Known Issues
Please visit .
Find help
Report a bug
Found a bug? You can report it at the .
FAQ
Here are some frequently asked questions that might help you.
Developers
Import source code to Eclipse
You can import the source code to a workspace in Eclipse by following the below steps.
Create / Select a workspace
- File / Import
- / Git / Projects from Git
- / Clone URI
- / Enter Github Repo
- / Select Master Branch
- / Select Destination
- / Import Existing Projects
- Click on Finish
Start the wallet from the Eclipse's workspace
When you have successfully imported Qora to your Eclipse's Workspace you then can start the wallet by following the below steps:
- Select the >Qora [Qora master] from Package Explorer, click on Run on menu bar and then Run again.
- Run as Java Application
- On the next step scroll down and click on the Start - (default package) and click OK
Compile Qora from source code
- Select the >Qora [Qora master] from Package Explorer
- Go to / File / Export / Java / Runnable JAR file
Export
- On Launch Configuration field select Start - Qora from the drop down menu. You will have to run the wallet first in order to have the option Start - Qora available
- / Select Export destination
- / Select Package required libraries into generated JAR
API
Qora uses a REST API to communicate with the wallet. You can find the entire API documentation here :
Submit a pull request
You can submit a pull request to the source code by following the below steps.