danicoin/README.md

105 lines
3.1 KiB
Markdown
Raw Normal View History

2018-01-24 15:55:58 +00:00
# Danicoin
2014-08-30 06:58:01 +00:00
2018-01-13 17:12:32 +00:00
This is Danicoin, the best cryptocurrency out there.
2014-08-30 06:58:01 +00:00
2018-01-29 17:48:38 +00:00
## Downloads
Binaries are available only for 64-bit Linux. You can find those in the
[Downloads Area](https://kumi.cloud/s/pce19vAOXh1lyZM).
If you are using a different operating system or architecture or can't get the
provided binaries to work, please try building Danicoin yourself.
2018-01-13 17:12:32 +00:00
## Building
2014-08-30 06:58:01 +00:00
2018-01-29 17:48:38 +00:00
To build Danicoin on an Ubuntu machine, you first need to install some
dependencies:
2014-08-30 06:58:01 +00:00
```
2018-01-29 16:57:59 +00:00
sudo apt install git build-essential cmake lib{boost-all,ssl}-dev pkg-config
```
2018-01-13 17:12:32 +00:00
You can then fetch the code and compile it like this:
```
2018-01-13 17:12:32 +00:00
git clone https://kumig.it/kumitterer/danicoin.git
cd danicoin
make
```
2018-01-13 17:12:32 +00:00
The binaries (you will primarily want to use danicoind and daniwallet) will be
placed into the "build/release/src" subdirectory of the danicoin source
directory. You may want to move them to /usr/bin like this:
```
2018-01-13 17:12:32 +00:00
sudo install build/release/src/dani{coind,wallet} /usr/bin
```
2018-01-29 17:48:38 +00:00
If you are trying to build Danicoin on anything else than a 64-bit Ubuntu
machine, your mileage may vary. Feel free to create an issue asking for help if
you are stuck.
2018-01-13 17:12:32 +00:00
## Usage
2018-01-13 17:12:32 +00:00
### danicoind
2018-01-13 17:12:32 +00:00
Danicoin's core component is the daemon, danicoind. It is responsible for
keeping your copy of the blockchain in sync. Assuming you have installed it to
/usr/bin as seen above, you can just fire it up like this:
2018-01-13 17:12:32 +00:00
```
danicoind
```
2018-01-13 17:12:32 +00:00
Please note that running it for the first time might take a while as the entire
blockchain will have to be downloaded.
2018-01-13 17:12:32 +00:00
danicoind should not require any configuration as such. By default, it will
store its data, including a full copy of the blockchain, in the ".danicoin"
subdirectory of your user directory.
2018-01-13 17:12:32 +00:00
If you need to change any settings, you may pass them as arguments to danicoind
or write them to a configuration file. If a "danicoin.conf" file exists in the
data directory (~/.danicoin), its settings will be used by default.
2018-01-13 17:12:32 +00:00
You can find the arguments accepted by danicoind by executing:
2018-01-13 17:12:32 +00:00
```
danicoind --help
```
2018-01-13 17:12:32 +00:00
A sample configuration file can be found [in this repository](/danicoin.conf).
2018-01-13 17:12:32 +00:00
### daniwallet
2018-01-13 17:12:32 +00:00
The easiest way to create and manage Danicoin wallets is using daniwallet. To
create your first wallet, named "mywallet" in this example, execute:
2018-01-13 17:12:32 +00:00
```
daniwallet --generate-new-wallet mywallet
```
2018-01-13 17:12:32 +00:00
daniwallet will then ask you for a password and generate your new wallet. Two
files will be stored in your current working directory - mywallet.wallet and
mywallet.address. mywallet.wallet contains the actual wallet, mywallet.address
contains the wallet address you use to receive payments.
2018-01-13 17:12:32 +00:00
In order to use daniwallet with an existing wallet, navigate to the directory
containing your mywallet.wallet, then execute:
2018-01-13 17:12:32 +00:00
```
daniwallet --wallet-file mywallet
```
2018-01-13 17:12:32 +00:00
Once daniwallet is running, you can, for instance, type in "balance" and press
Enter to see your current balance. To transfer money to another wallet, you may
use the following command (replacing "recipient_address" with the actual address
of the receiving wallet and "amount" with the amount of Danicoin to send):
2018-01-13 17:12:32 +00:00
```
transfer 3 recipient_address amount
```
2018-01-13 17:12:32 +00:00
You can find out about the other commands using "help".