Skip to content

Latest commit

 

History

History
319 lines (204 loc) · 7.89 KB

XDAGJ_TestNet_Tutorial_en.md

File metadata and controls

319 lines (204 loc) · 7.89 KB
Raw

XDAGJ Test Network Access Tutorial

At this stage, XDAGJ only provides pool functions, and users can use the original C language version of the XDAG client wallet to participate in the test. The environment provided in this tutorial is not necessary, and users can perform the corresponding steps according to their own operating system

Wallet Access Tutorial

MacOS/Linux Command Line Wallet

Currently there is no visual wallet on MacOS and LInux platforms, users need to compile the corresponding client according to their own environment

Note: Because the RanndomX algorithm requires a large amount of system memory, running a command line wallet needs to ensure that the available memory of the system is greater than 5G

MacOS

System version：MacOS BigSur 11.2.3

  • Install dependencies

    brew install cmake openssl libtool gmp autoconf

  • RandomX dependency (compile the project for the first time)

    git clone https://github.com/tevador/RandomX.git
cd RandomX
mkdir build && cd build
cmake -DARCH=native ..
make
sudo make install

  • Download source code

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

  • Compile libsecp256k1 (compile the project for the first time)

    cd xdag/secp256k1
./autogen.sh
./configure
make
./tests
sudo make install

  • Build XDAG client

    mkdir build && cd build
cmake .. -DBUILD_TAG=mac
make

Ubuntu

System version : Ubuntu20.04 LTS

  • Install dependencies

    apt-get install cmake gcc build-essential pkg-config libssl-dev libgmp-dev libtool libsecp256k1-dev librandomx-dev

  • Turn on hugepage for RandomX algorithm

    • Temporarily
    sudo sysctl -w vm.nr_hugepages=2560
    • Permanently
    sudo bash -c "echo vm.nr_hugepages=2560 >> /etc/sysctl.conf"

  • Download source code

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

  • Build XDAG client

    cd xdag
mkdir build && cd build
cmake .. 
make

Usage

  • Connect to the pool

    ./xdag -t -randomx f -m <mining thread> <pool ip>:<port>

    -m is an optional item, indicating the mining thread, the default is 0, that is, no mining operation

  • First run

    • The first time you run the system, you will be prompted to set password, which is used to transfer funds and unlock wallet information. Please keep in mind that once the password is lost, it cannot be retrieved
    • enter random charactersThis field is a random number seed, used to strengthen the randomness of the file, not a password
    • It will take some time to generate your wallet address, please wait patiently until the xdag> field appears

  • Check the connected status

    xdag> state
[show current network status

  • Check balances

    xdag> balance
[show all balances of your account]

  • Show XDAG address

    xdag> account
[display the xdag address owned by the account]

  • Transfer

    xdag> xfer
[xfer  amount  address]

  • drop out

    xdag> terminate

  • More command line instructions

    ./xdag -h
#or
xdag> help

    For more detailed information, please refer to XDAG

Windows Visual Wallet

Download the visual wallet from github, download link

After decompression, open the wallet-config.json file, modify pool_address to the testnet mining pool address, and modify is_test_net to true

Wallet Backup and Restore

It is strongly recommended that you store the testnet and mainnet wallets separately to avoid accidental loss of mainnet wallet data

Backup

  • 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

Please remember the password set during the first run. If the password is lost, the wallet file cannot be decrypted correctly and the corresponding account cannot be retrieved

Recover

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

Mining Tutorial

Note 1: To use mining software, a miner needs to take up 2.5G of running memory, which grows linearly with the number of miners. If multiple miners are used, make sure that the opened memory page is 1280*corresponding to the number of miners

Note 2: Please make sure that the wallet address has been confirmed on the XDAG network, otherwise the mining operation cannot be performed

MacOS

  • Install dependencies

    brew install boost

  • Download source code

    git clone https://github.com/XDagger/XdagRandomxMiner.git

  • Build(compile RandomX for the first time,ref Mac build RandomX

    mkdir build && cd build
cmake ..
make

  • Start

    ./DaggerMiner -cpu  -T -p <pool ip:port> -t <number of mining threads> -a <wallet address>

Linux

  • Install dependencies

    apt-get install cmake libboost-all-dev  openssl librandomx-dev

  • Download source code

    https://github.com/XDagger/XdagRandomxMiner.git

  • Build

    mkdir build && cd build
cmake ..
make

  • Linux system turns on hugepage for RandomX algorithm

    • Temporarily
    sudo sysctl -w vm.nr_hugepages=1280
    • Permanently
    sudo bash -c "echo vm.nr_hugepages=1280 >> /etc/sysctl.conf"

  • Start

    ./DaggerMiner -cpu  -T -p <pool ip:port> -t <number of mining threads> -a <wallet address>

Windows

It is recommended to download XDAG's dedicated mining software XdagRandomXMiner for win Please refer to Win10 Configuration RandomX or Enable the Lock Pages in Memory Option (Windows) to open the hugepage

  • Start command

    DaggerMiner.exe -cpu -T -p <pool ip:pool port> -t <thread number> -a <account address>

  • Common problem

General question

Mining shows Dataset allocation failed, confirm that hugepage has been successfully configured, otherwise please ensure that the system memory is sufficient to support the memory required by a miner

Pool Address

ShangHai: 1.15.78.91:9992

Other

Now you can access the XDAGJ test network and perform the transfer function. At the same time, you can check the information you want to know in the browser

We welcome you to inform us about errors in the use process or any other information that can help us improve the project. You can give us feedback through Issues

If you have other questions, or if you want us to provide more tutorials, you can also ask questions in [Issues](