Getting started

Topic

• Installation and Connecting
• Usage (Windows GUI)
• Usage (command line)
• Backup and Recovery
• Set up a pool
• Set up a test network environment

Installation and Connecting

Binaries for Windows and MacOS

• Download the binary from the release page
• Unextract the software
• XDAG is run from and saves files within its own directory
• For the command line version on Windows, please run from a cmd window
• For MacOS, run from a terminal window

Building from source for MacOS

• Install dependencies

    $ brew install openssl
    $ ln -s /usr/local/opt/openssl/include/openssl /usr/local/include
    $ ln -s /usr/local/opt/openssl/lib/libssl.1.0.0.dylib /usr/local/lib/
  

• Clone from the git repository

    $ git clone https://github.com/XDagger/xdag
  

• Build the client

  With make

    $ cd xdag/client
    $ make
  

  With automake

    $ cd xdag/automake
    $ autoreconf -if
    $ ./configure
    $ make
    $ cd ../client
  

Building from source for Linux

• Install dependencies

    fedora $ sudo dnf install git gcc openssl-devel libgmp-dev
  

  or

    debian $ sudo apt-get install git gcc libssl-dev libgmp-dev
  

• Clone from the git repository

    $ git clone https://github.com/XDagger/xdag
  

• Build the client

  With make (old method)

    $ cd xdag/client
    $ make
  

  With automake (new method)

    $ cd xdag/automake
    $ autoreconf -if
    $ ./configure
    $ make
    $ cd ../client
  

Usage (Windows GUI)

todo

Usage (command line)

• Connecting to a pool

  • Windows

      xdag -m 0 pool.address.here:13654
    

  • MacOS and Linux

      ./xdag -m 0 pool.address.here:13654
    

• First run

  • Upon the first run, you will be prompted to enter random characters.

    Do so. Make it long and very random. This is not a password.

  • You will then be prompted for a wallet password. Enter one if desired, then hit OK.

  • Generation will take some time; please be patient.

  • When the software is ready, you will be presented with an xdag > prompt.

• Get the pool connection status

  state
  [software state is shown]
  

• Retrieve your balance

  balance
  [balance info is shown]
  

• Show your XDAG address

  account
  [address with balance is shown]
  

• Transfer funds to another address

  xfer <amount> <address>
  

• Exit the software

  terminate
  

Backup and Recovery

• It is advised to back up the entire working directory, and store read-only.

• The important files to keep are wallet.dat, dnet_key.dat and the storage folder.

• To recover, place the above noted files in your newly extracted or compiled client directory.

Set up a pool

Todo

Set up test network environment

• Modify code Change #define PREVENT_AUTO_REFRESH 0 to #define PREVENT_AUTO_REFRESH 1 in netdb.c

• Build Build your own version.

• Setup internal testnet
  1. Plan your testnet topology.
  2. Modify netdb-testnet.txt and netdb-white-testnet.txt with your IPs.
  3. Launch your hosts with -t option.
  4. Launch your miner/wallet with -t option.
  5. Currently only command line miner/wallet able to join testnet.