Introduction

Once you have correctly set up your instance, installed the different programs, either from the installer script or manually, you can now register as a delegate of the X-Cash Public Network. You will need to have all the services already running to generate the necessary parameters to register yourself as a delegate.

1. Generate a Block Verifier Key

The block verifier key is a unique identifier generated by a delegate and is used in the consensus process to sign messages and verify the information. As a delegate, you will need to generate a block verifier key before being able to register yourself in the system.

First of all, stop the currently running process of the xcash-dpops program.

systemctl stop xcash-dpops

Then, run the xcash-dpops program with the --generate-key option. The program is located in the xcash-dpops/build folder. Run the command:

~/xcash-official/xcash-dpops/build/xcash-dpops --generate-key

You will be given a public key and private key.

Block Verifier Key
XCASH DPOPS - Version 1.0.0
---------------------------
Public Key:
cf8718d638ce0a831f3538ea60d1e27c3a258c7004a1ad7c547cc5331de7d9d7
Secret Key:
ca1319431124f55fa0d9e0fcc84edd780f80da7d91f08d334fac17c803934ecccf8718d638ce0a831f3538ea60d1e27c3a258c7004a1ad7c547cc5331de7d9d7

2. Register Yourself as a Delegate

Now that you have generated your block verifier key pair, you can register yourself as a delegate. You will need to prepare a delegate name, your server IP address or domain name, and the block verifier public key. Furthermore, you will have to register from the wallet you will be using to collect the reward.

First of all, the wallet service should be running in the background. Stop it by using the command:

systemctl stop xcash-rpc-wallet

Open and let synchronize your wallet generated during the node installation, either when using the auto-installer or created manually.

~/xcash-official/xcash-core/build/release/bin/xcash-wallet-cli --wallet-file ~/xcash-official/xcash-wallets/<WALLET_NAME>

Replace the <WALLET_NAME> with your own.

Once your wallet is fully synchronized, you can use the delegate_register command with the following parameters:

delegate_register <delegate_name> <IP_address|domain_name> <block_verifier_public_key>

And replace the information with:

• <delegate_name>: the name that will be displayed on the delegate explorer. Cannot be updated.

• <IP_address|domain_name> : your server's IP address or its domain name (if you have bought a domain name and correctly set up the DNS record). It is possible to change this information at a later time. Can be updated.

• <block_verifier_public_key> : the block verifier public key that you have generated earlier. Cannot be updated.

Example:

delegate_register my_delegate my_delegate.domain.com cf8718d638ce0a831f3538ea60d1e27c3a258c7004a1ad7c547cc5331de7d9d7

You will be prompted to wait for the next valid data interval. Once your request has been accepted, you will receive the message The delegate has been registered successfully.

You can exit the wallet and restart the wallet service:

systemctl daemon-reload

Now, you will need to use your block verifier secret key as a parameter to let the program identify that you are the one signing messages.

First of all, stop the currently running process of the xcash-dpops program.

systemctl stop xcash-dpops

Then, add your block verifier secret key as a parameter in the service. See the setup of the services guide to see how to edit the unit file.

Once done, make sure to restart systemctl:

systemctl daemon-reload

3. Update Public Information

Each registered delegates will be displayed in the delegates explorer, along with their statistics and information. At registration, the minimum information that is displayed is your delegate name and IP address. You can add additionnal instructions to help other identify you or rally to your cause and vote for you.

First of all, the wallet service should be running in the background. Stop it by using the command:

systemctl stop xcash-rpc-wallet

Open and let synchronize the wallet you used to register as a delegate, either when using the auto-installer or created manually.

~/xcash-official/xcash-core/build/release/bin/xcash-wallet-cli --wallet-file ~/xcash-official/xcash-wallet/<WALLET_NAME>

Replace the <WALLET_NAME> with your own.

Once your wallet is fully synchronized, you can use the delegate_update command with the following parameters:

delegate_update <item> <value>

Replace the <item> with one of the list below, and change the correspondig <value>

You will be prompted to wait for the next valid data interval. Once your request has been accepted, you will receive the message The delegate info has been updated successfully.

You can exit the wallet and restart the wallet service:

systemctl start xcash-rpc-wallet

4. Shared Delegates

If you plan on being a delegate but need to accept people vote to help you place in the top delegates spot and earn the right to forge blocks, you will need to run a shared delegate. The shared delegates website will automatically pay your voters taking into account their share.

Quick Setup

bash -c "$(curl -sSL https://raw.githubusercontent.com/X-CASH-official/xcash-dpops/master/scripts/autoinstaller/autoinstaller.sh)"

Manual Setup

To run your node as a shared delegate, you just need to run the xcash-dpops program with the following added set of parameters:

--shared-delegates-website --fee <fee> --minimum-amount <amount>

With :

• <fee> : Your delegate fee is the amount of the block reward you are keeping to yourself. The <fee> is expressed in percentage (%) and can take up to 6 decimals.

• <amount> : The minimum amount of XCASH that can be sent to voters as part of their payment. Has to be an integer number.

Example

--shared-delegates-website --fee 12.092032 --minimum-amount 10000

Will register as a shared delegate, taking a fee of 12.092032% from the block reward, and process payments to voters when they have accumulated to 10,000 XCASH.

Update the xcash-dpops program

To make sure that your node is running with the parameters, you should update the unit files and restart the service.

First, make sure to stop the running xcash-dpops service:

systemctl stop xcash-dpops

Then, edit the unit file:

nano /lib/systemd/system/xcash-dpops.service

And add the parameters to the ExecStart variable:

XCASH_DPOPS.service
[Unit]
Description=XCASH DPOPS
​
[Service]
Type=simple
LimitNOFILE=infinity
User=root
WorkingDirectory=~/xcash-official/xcash-dpops/build
ExecStart=~/xcash-official/xcash-dpops/build/xcash-dpops --block-verifiers-secret-key BLOCK_VERIFIER_SECRET_KEY --shared-delegates-website --fee <fee> --minimum-amount <amount>
Restart=always
​
[Install]
WantedBy=multi-user.target

--block-verifiers-secret-key BLOCK_VERIFIER_SECRET_KEY

Build the shared delegate website

As a shared delegate, you will need to pay your voters a share of the block reward. We have designed a delegate pool website, which works similarly to a regular PoW pool website, where your voters can see their pending payments, your forging statistics and so on...

First, install the website dependencies:

NodeJS

Install nodeJS latest available version:

sudo apt install nodejs

And update to the latest version using this tutorial.

npm

npm config set user 0
npm config set unsafe-perm true

Install npm globally:

npm install -g npm

Angular & Uglify JS

Install Angular and UglifyJS globally:

npm install -g @angular/[email protected] uglify-js

Build

Once all dependencies are installed, clone the delegate pool website repository :

cd ~/xcash-official && git clone https://github.com/X-CASH-official/delegates-pool-website.git

Go into the folder, install the dependencies, and build the website:

cd ~/xcash-official/delegates-pool-website
npm update
npm run build

It will build in the distfolder.

Compress the .js files with Uglify-JS and move all of the contents of this folder to your xcash-dpops/ folder:

cd ~/xcash-official/delegates-pool-website/dist
for f in *.js; do echo "Processing $f file.."; uglifyjs $f --compress --mangle --output "{$f}min"; rm $f; mv "{$f}min" $f; done
rm -r ~/xcash-official/xcash-dpops/delegates-pool-website
mkdir ~/xcash-official/xcash-dpops/delegates-pool-website
cd ..
cp -a dist/* ~/xcash-official/xcash-dpops/delegates-pool-website

And you are done 🎉 Verify that you are listed in the delegate explorer, and start advertising your node to get people joining your cause and vote for you!