This script is used to install a vps masternode of Absolute coin (ABS) with ipv4 only. If you have a vps that has both, ipv4 and ipv6 enabled then look for multi node vps install script.
The source of this script and documentation is ABS wiki on github found here: https://github.com/absolute-community/absolute/wiki
To install the node you need the following:
- a control wallet on your PC, MAC or Linux computer
- 2500 ABS coins that will be used as collateral
- a vps server running Ubuntu Linux 18.04 or 20.04
1. On your local computer
Download the last version of ABS wallet from the github repository found here:
https://github.com/absolute-community/absolute/releases
Then you need to generate a few new ABS address in your control wallet.
First one is the masternode collateral address. Open Debug Console from Tools menu of your control wallet and paste the next command:
getaccountaddress MN1
MN1 is just an alias associated with the generated address.
Send the collateral - 2500 ABS - to the address generated above. Make sure that you send exactly 2500 ABS to that address. Make sure that the <Substract fee from amount> option is not checked.
You need to wait for 15 confirmations (to be safe) before you can obtain transaction id and index with the next command run in debug console:
masternode outputs
To connect your vps with the cold wallet you need a bls masternode private key (bls private and public keys pair).
To get the bls private key pair run this command in debug console:
bls generate
You need to store these keys as they will be used later on the install script (bls private key) and on protx cmd (bls public key).
From v13 wallet, we will need two new addresses - owner address (must be new and unused) and voting address - run these 2 cmds in debug console:
getaccountaddress MN1-OWN
getaccountaddress MN1-VOT
NOTE: Voting rights can be transferred to another address or owner... in this case last command will not be necessary instead use that address as a voting address.
Optional, to keep track of your masternode payments you can generate another new address like this:
getaccountaddress MN1-PAYMENTS
If this is not a priority you can use your main wallet address. Note that you need to have some ABS here to cover few transactions fees (1 ABS will do - must be confirmed - atleast 6 blocsk old).
Optional, another address can be generated and used to cover fees for your masternodes transactions. You need to fund this address and use it on your protx command.
getaccountaddress MN-FEES
I won't use it with this script, fees will be covered from the main wallet address.
2. On your vps server
Use Putty to connect to your vps via ssh. Make sure you have at least Ubuntu Linux v18.04 installed.
Have closed by the things prepared above: [bls private key], script will ask for it.
You need to be root, so, if you use a different user to login to your vps then switch the current user to root and navigate to /root folder with this shell command:
cd /root
Download the install script with this command:
wget https://bit.ly/abs_vps_install -O abs_vps_install.sh && chmod +x abs_vps_install.sh
Start the install script with the next command. You need to provide the bls private key generated earlier.
./abs_vps_install.sh
Make sure that the script run without errors!
Some warnings may occure, for example if you run the script twice for some reason.
You can now start the ABS daemon with this command:
systemctl start absd
At this point, the daemon start to download the ABS blockchain and sync with the network. This process takes about half hour, depending on your vps internet connection.
To check if the vps is synced with the network use this command:
absolute-cli getinfo
Check that the last block is the one as on ABS explorer found here:
http://explorer.absify.me
To check if the masternode started succesfully type next command on your vps:
absolute-cli masternode status
Note: you need to have vps cold node synced before you continue with the part 3!
3. On your control wallet
On your control wallet you need to run few commands to prepare, sign and sumbit a special ProRegTx transaction that will activate your masternode.
Note: Make sure your wallet is unlocked!
Step 1. Prepare a unsigned special transaction.
Synthax:
protx register_prepare collateralTx collateralTxIndex ip:port ownerAddr operatorBlsPubKey votingAddr operatorReward payoutAddr (feeSourceAddr)
You can use a text editor to prepare this command. Replace each command argument as follows:
- collateralTx: transaction id of the 2500ABS collateral
- collateralTxIndex: transaction index of the 2500ABS collateral
- ip:port: masternode ip and port
- ownerAddr: new ABS address generated above
- operatorBlsPubKey: BLS public key generated above
- votingAddr: new ABS address generated above or the address used to delegate proposal voting
- operatorReward: percentage of the block reward allocated to the operator as payment (use 0 here)
- payoutAddr: new or main wallet address to receive rewards
- feeSourceAddr: (optional) an address used to fund ProTx fee, if missing, payoutAddr will be used
Note: if you use a non-zero operatorReward, you need to use a separate update_service transaction to specify the reward address (not covered by this how-to).
Example command:
protx register_prepare
75babcc7660dbce0d8f8c6ac541eabc0e7844e74e03b4ec4f85df902a1264099
0
65.21.144.60:17777
yjSSuGj2Num4cJmswrEyks1yUqSZ6PT9T2
15d473ecc5b48f0f19c18a5bc78ae19dc722ccf22570f98ffc5945cdf4eda9539c421418e2cfb5e41fe0b6cb4d73d1f1
ye2ZCAVkUEfvVyTLYDqmMG7aEZKtDeeEpn
0
yhWybg5sRZHopwwDHU7CRPkYiXUk9TgTV1
Result:
{
"tx": "030001000180b191aa19030230c250064c9217f327fafd70b222fa7d6a3a50e8e774fc1a300000000000feffffff0121dff505000000001976a914e888e2ac0f029208e2ac59572740dcc66b3c4c4888ac00000000d1010000000000994026a102f95df8c44e3be0744e84e7c0ab1e54acc6f8d8e0bc0d66c7bcba750000000000000000000000000000ffff4115903c4571fd9dd95354f9c9e0c2ff15c503f2fb4c2effb4fe15d473ecc5b48f0f19c18a5bc78ae19dc722ccf22570f98ffc5945cdf4eda9539c421418e2cfb5e41fe0b6cb4d73d1f1c2407d14cacc4c275e35918102216c973ad1561b00001976a914e888e2ac0f029208e2ac59572740dcc66b3c4c4888ac216cf434d24a2547c9f0763a16a9bf2a695cac3d2c54dd9208bd631446f433d900",
"collateralAddress": "yXUmTnwkZrmXeSy1FwUr9pBcZPPtWjcT6M",
"signMessage": "yhWybg5sRZHopwwDHU7CRPkYiXUk9TgTV1|0|yjSSuGj2Num4cJmswrEyks1yUqSZ6PT9T2|ye2ZCAVkUEfvVyTLYDqmMG7aEZKtDeeEpn|5ccbe02fb852dcb5b11358de2d5cc9bd17db70d0b271ceb381328404830f34d2"
}
Note: protx command should be one line with only one space between arguments.
Step 2. Sign the message from previous command with the collateral address resulted above.
Example command:
signmessage yXUmTnwkZrmXeSy1FwUr9pBcZPPtWjcT6M yhWybg5sRZHopwwDHU7CRPkYiXUk9TgTV1|0|yjSSuGj2Num4cJmswrEyks1yUqSZ6PT9T2|ye2ZCAVkUEfvVyTLYDqmMG7aEZKtDeeEpn|5ccbe02fb852dcb5b11358de2d5cc9bd17db70d0b271ceb381328404830f34d2
Result:
H2rV31nqSkcWNqBhCYhCYYmKVTlQkzVjfzCvuqIjocknTPtzC3BgRgJR/uoPbNH8YHpETTYuhp+6Ms22gzeHsqg=
Step 3. Submit transaction and signature resulted above.
Example command:
protx register_submit 030001000180b191aa19030230c250064c9217f327fafd70b222fa7d6a3a50e8e774fc1a300000000000feffffff0121dff505000000001976a914e888e2ac0f029208e2ac59572740dcc66b3c4c4888ac00000000d1010000000000994026a102f95df8c44e3be0744e84e7c0ab1e54acc6f8d8e0bc0d66c7bcba750000000000000000000000000000ffff4115903c4571fd9dd95354f9c9e0c2ff15c503f2fb4c2effb4fe15d473ecc5b48f0f19c18a5bc78ae19dc722ccf22570f98ffc5945cdf4eda9539c421418e2cfb5e41fe0b6cb4d73d1f1c2407d14cacc4c275e35918102216c973ad1561b00001976a914e888e2ac0f029208e2ac59572740dcc66b3c4c4888ac216cf434d24a2547c9f0763a16a9bf2a695cac3d2c54dd9208bd631446f433d900 H2rV31nqSkcWNqBhCYhCYYmKVTlQkzVjfzCvuqIjocknTPtzC3BgRgJR/uoPbNH8YHpETTYuhp+6Ms22gzeHsqg=
Result:
a12cbb3e286b53822e3c150ff1c8de2b6712e9dcbc29e9f54457440c245b7df5
Congratulations, your Absolute MasterNode is running!
You can use ufw firewall combined with fail2ban to secure your vps against attacks comming from internet. Open ssh and abs port in firewall and enable ufw with the next commands:
ufw allow 22/tcp
ufw allow 18888/tcp
ufw enable
Good luck!
If you run into problems ask for help in ABS discord support channel.