decus.io
Search
K

How to Run a Keeper Node?

In this article, we’ll give a step-by-step instructions on how to run a Keeper Node and claim the rewards as a Keeper on the Binance Smart Chain Mainnet.
Risk Disclaimer:
Our project is still in the mainnet Beta version. The security audit is still in progress.
The 0.1 BTCB you deposit to the DeCus system will be staked for 6 months at most and cannot be withdrawn during this period.
Joining in our system in this early stage should be considered of high risk, please participate at your own risk.

About Keepers

Who are Keepers? In the system of DeCus, Keepers are responsible for the custody of underlying crypto assets. All keepers are organized under the overlapping group assignments in a 100% decentralized way. Anyone who wants to become a Keeper need to deposit collaterals and run a Keeper node.

What Do You Need?

To create a keeper node you require:
  • Time and patience
The whole process takes over half an hour, and may be interrupted by some faulty operations, but we still recommend trying to get it done all in one go.
  • A new Bitcoin wallet
Please create a new BTC address, and don't send any asset to this address.
Please don't use hardware wallet.
  • A new Binance Smart Chain wallet, 0.1 BTCB and BNB
Please create a new BSC address, and don't send any asset to this address except staked BTCB and some BNB for paying gas fee.
Please don't use hardware wallet.
  • A server
Please use a server with 1CPU core and 1GB RAM. You can purchase one on Digital Ocean or Alibaba Cloud.
If you purchase on Digital Ocean, please choose the "Password" option when you proceed to the Authentication step.
After the successful purchase, remember to save the IP address and password of the cloud server for later use.
All the preparations are done! Let’s get this going!

4 Steps to Set up a Keeper Node

Step 1: Add Keeper

2.Switch to the Binance Smart Chain Mainnet, and connect your wallet
3.Click ‘Add Keeper’, and confirm transaction twice on your MetaMask, this step will lock your BTCB into the contract as collateral for running keeper node.
4.This step is successfully done when the website page shows as the following picture.

Step 2: Log in to your server

1.Launch the command line
On MacOS: Launch Terminal by going to Applications > Utilities > Terminal.
On Windows: Launch the Command Line / CMD by pressing the Windows / Start button, typing in ‘CMD’, and opening ‘Command Line’, or ‘cmd.exe’, whatever your computer shows.
2.Type the following command line, and hit enter.
ssh root@‘Your IP Address’
‘Your IP Address’ should be replaced with the address provided by Digital Ocean.
3.The terminal will prompt for a password. Input the password of the server and hit enter.
4.If the password needs to be confirmed, please input it again and hit Enter.
5.The connection is successful when the following command lines are shown on the Terminal.

Step 3: Deploy the Node

Initialization setting
1.Type the following command line, and hit enter.
vi ./pwd
2.Switch to the writable state (this step is not required for Windows systems) by typing「 i 」
3.The switch is successful when ‘INSERT’ shows on the Terminal.
4.Set the password and save it to a cloud file or notepad for later use.
5.Click ‘ESC’, type「 :wq 」, and hit Enter.
Install the firewall
  • If the cloud server is an Ubuntu system, please type the following command lines to install the firewall in turn.
sudo ufw allow 22/tcp
yes | sudo ufw enable
  • If the cloud server is a Centos system, please type the following command lines to install the firewall.(You can directly do a copy and paste.)
sudo yum install firewalld
sudo systemctl enable firewalld
firewall-cmd — state
sudo firewall-cmd — permanent — add-port=22/tcp
sudo systemctl restart firewalld
Install Docker and check the version
1.Type the following command lines.
sudo apt-get update
sudo apt-get remove docker docker-engine docker.io
sudo apt install docker.io curl -y
sudo systemctl start docker
sudo systemctl enable docker
2.Type the following command line, and hit enter. Docker is successfully installed when “Docker Version XX.XX.X” shows on the Terminal.
sudo docker --version
Deploy the node
1.Type the following command line, and hit enter.
docker run -it -e PASSWORD=$(cat ./pwd) -v keeper-user:/app/user decusio/keeper-client:latest init
2.Input the RPC URL, the private key of BSC address and BTC address, along with your frequently-used email to receive the notifications.
*We recommend using https://nodereal.io/ for rpc on BSC testnet*, for simplicity, just use https://bsc-testnet.nodereal.io/v1/d8d8a4dd985a45e1a4eff1f96064c85f
(you can jump to next step if using the rpc we provided)You can select one RPC URL of the BSC Mainnet from the official list: https://docs.binance.org/smart-chain/developer/rpc.html
3.Type the following command line, and hit enter.
docker run -d --restart always -e PASSWORD=$(cat ./pwd) -v keeper-user:/app/user --name keeper-client decusio/keeper-client:latest
4.Type the following command line, and hit enter. If the node runs successfully, the keeper-client will show on the Terminal.
docker ps
5.Type the following command line, and hit enter to check the logs.The Keeper ID, Chain ID, etc. The following picture will show if there is a successful deployment.
docker logs keeper-client -f

Step 4: Join our Discord to keep updated

After setting up the Keeper node, don't forget to join our discord otherwise you'll miss the important notifications to Keepers. You can also discuss with other Keepers and get timely responses if any problems occur.

Check Online Status & Claim Rewards (Not available)

After successfully running a Keeper Node, your BSC address will receive the DCS-CT. You need to stake the DCT-CT to claim your DCS rewards.
1.Visit this link: https://app.decux.io/keeper/stake . You can check keeper node's online status and the balance of DCS-CT.
The number below the online status is the BTC address of keeper.
*If the balance is 0, please refresh the page.
2.Click “Approve”, and confirm the transaction in MetaMask
3.Click “Stake”, enter the amount of DCS-CT you want to deposit, Then confirm the transaction in MetaMask.
4.After successfully staking the Ctoken, you will see the DCS rewards that can be claimed. Click “Claim” to get your rewards.
5.Once finished, you need to add DCS tokens in MetaMask to see the balance, the contract address of DCS (unpublished)

How to Leave the Network?

In order to test the system's ability to run stably for a long time, the BETA version will keep running for about 6 months, during which the keeper nodes cannot leave the network and the BTCB they staked to the platform will be locked in the contract and cannot be redeemed. The exit function may go live earlier depending on the operation of the system, the specific time and steps about how to leave the network will be announced through official channels, please keep up with our website, Twitter and Discord.
Risk Disclaimer:
Our project is still in the mainnet Beta version. The security audit is still in progress, and the system has not gone through any penetration test yet. The 0.1 BTCB you deposit to the DeCus system will be staked for 6 months at most and cannot be withdrawn during this period. Although we have established several risk prevention mechanisms to safeguard all assets, participating in our system in this early stage should be considered of high risk, please assess the potential uncertainties carefully.