Applications & Tools
Delegate node & staking
XCASH Namespace (in development)
XCASH Turbo Tx (in development)
Register Delegate
Once your server is set up and the necessary programs installed, you will be able to register yourself as a delegate.
Introduction
Once you have correctly set up your instance, installed the different programs, 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. Register Yourself as a Delegate
You should have noted your block verifier keys during the program installation. 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 used to collect the reward.
Chose your delegate name wisely as you won't be able to change it down the line. If you want to change the name, you will have to generate a new block verifier key pair and register yourself again, but you will however lose your previous delegate stats.
First of all, the wallet service should be running in the background. Stop it by using the command:
1
systemctl stop xcash-rpc-wallet
Copied!
Open and let synchronize your wallet generated during the node installation, either when using the auto-installer or created manually.
1
~/xcash-official/xcash-core/build/release/bin/xcash-wallet-cli --wallet-file ~/xcash-official/xcash-wallets/<WALLET_NAME>
Copied!
Replace the
<WALLET_NAME> with your own.If you installed with the auto-installer script, the wallet name will be
delegate-walletOnce your wallet is fully synchronized, you can use the
delegate_register command with the following parameters:1
delegate_register <delegate_name> <IP_address|domain_name> <block_verifier_public_key>
Copied!
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 recommended to register your delegate using your domain name, as you can redirect your server IP address to it easily in your DNS record, enabling you to change server in the future. It is however 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:
1
delegate_register my_delegate my_delegate.domain.com cf8718d638ce0a831f3538ea60d1e27c3a258c7004a1ad7c547cc5331de7d9d7
Copied!
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:1
systemctl restart xcash-rpc-wallet
Copied!
2. 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 additional instructions to help others 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:
1
systemctl stop xcash-rpc-wallet
Copied!
Open and let synchronize the wallet you used to register as a delegate, either when using the auto-installer or created manually.
1
~/xcash-official/xcash-core/build/release/bin/xcash-wallet-cli --wallet-file ~/xcash-official/xcash-wallets/<WALLET_NAME>
Copied!
Replace the
<WALLET_NAME> with your own.If you installed with the autoinstaller script, the wallet name will be
delegate-walletOnce your wallet is fully synchronized, you can use the
delegate_update command with the following parameters:1
delegate_update <item> <value>
Copied!
Replace the
<item> with one of the lists below, and change the corresponding <value>Item
Type
Description
aboutString (1024 char. max.)
Short description about you and your motivations as a delegate.
Example:
delegate_update about Even the smallest delegate can change the course of the future.IP_addressString (255 char. max.)
Update the IP address or domain name of your delegate node. Must be in IPV4 format
Example:
delegate_update IP_address mydomain.com websiteString (255 char. max.)
Link to your landing page or website relating to your delegate information and statistics.
Example:
delegate_update website my-delegate-website.comteamString (255 char. max.)
In case of delegate node managed by several persons. Can be a team name, names or GitHub profiles.
Example:
delegate_update team Manager: @tic | Treasury: @tacshared_delegate_statusString (255 char. max.)
solo: for a solo delegates.
shared: for shared delegates. Shared delegates set up a fee and redistribute a share of the reward to their voters.
group: for private groups. Private groups works as shared but the delegate decide how he/she going to distribute the votes. See how to set it up below.​
Example:
delegate_update shared_delegate_status groupdelegate_feeNumber
[0 - 100] with up to 6 decimals
Fees (in percentage) taken by the shared delegate on the block reward. Provide the fee you have used during the node installation.
Example:
delegate_update delegate_fee 12.354321server_specsString (255 char. max.)
A description of the servers' specifications and hardware.
Example:
delegate_update server_specs Operating System = Ubuntu 20.04 - CPU = 6 threads (Intel E5-2630 v4 - 2.20GHz) - RAM = 16GB DDR4 - Hard drive = 400GB SSD - Bandwidth Transfer = UnlimitedYou 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:1
systemctl start xcash-rpc-wallet
Copied!
3. Private group
A shared delegate can choose to run a private group, where the delegate decide which voters is getting a share of the block reward. This set up is favorable for people running a shared delegate group with a closed group of people, and only want to retribute this select group.
To change this setting, you will need to make some changes in the
xcash-dpops.service and create a special configuration file that will list the wallet address you wish to send block reward payments to.First, you will need to create a configuration file that will list the wallet address you will distribute to.
1
nano ~/xcash-official/xcash-dpops-configuration.txt
Copied!
Then, you will need to add the addresses to distribute to in your list following the following format:
1
# Comment
2
wallet1|voting-address|payment-address
3
wallet2|voting-address|payment-address
Copied!
Where
voting-address is the wallet address used to vote for the delegate, and payment-address is the wallet you want to distribute the share of the block reward to.The
voting-address and payment-address can be the same.The maximum amount of
payment-address that can be in the list is 100.Once the config file is ready, save it and close. You will need to update the
xcash-dpops.service so it can get the configuration file. First, run the stop program option in the installer script: 1
bash -c "$(curl -sSL https://raw.githubusercontent.com/X-CASH-official/xcash-dpops/master/scripts/autoinstaller/autoinstaller.sh)"
Copied!
And choose option 13. Once the programs are stopped, open the
xcash-dpops.service located in /lib/systemd/system/and add the parameter --private-group <path-to-configuration-file>to the ExecStart line.1
nano /lib/systemd/system/xcash-dpops.service
Copied!
xcash-dpops.service
1
[Unit]
2
Description=X-Cash DPOPS Daemon background process
3
​
4
[Service]
5
Type=simple
6
LimitNOFILE=infinity
7
User=root
8
WorkingDirectory=~/xcash-official/xcash-dpops/build
9
ExecStart=~/xcash-official/xcash-dpops/build/xcash-dpops --private-group ~/xcash-official/xcash-dpops-configuration.txt --block-verifiers-secret-key BLOCK_VERIFIER_SECRET_KEY
10
Restart=always
11
​
12
[Install]
13
WantedBy=multi-user.target
Copied!
Once done, save your changes and restart the programs by running the option 12 of the auto-installer script.
1
bash -c "$(curl -sSL https://raw.githubusercontent.com/X-CASH-official/xcash-dpops/master/scripts/autoinstaller/autoinstaller.sh)"
Copied!
4. Prepare shared delegate payments
As a shared delegate (normal or private group), you will have to distribute a share of the block reward to your voters. On the first payment threshold, the program will automatically distribute the voters' share from the delegate wallet. However, the delegate wallet is empty at first and you might be missing some unspents to conveniently pay your voters.
It is recommended to pre-fund your delegate wallet when first setting it up. We recommend pre-funding between 500k to 1M XCASH into the delegate wallet.