VPS Guide

This guide will help you set up and run your node on a Linux-based VPS using the CLI (Command Line Interface)

1️⃣ Download the CLI to your VPS

To download the CLI tool directly to your VPS, use the wget or curl command. This will save you the trouble of downloading it to your local machine and transferring it via FTP.

wget https://github.com/xprotocol-org/xardian/releases/latest/download/runner.linux.amd64

For macOS, you can use this command:

curl -LO https://github.com/xprotocol-org/xardian/releases/latest/download/runner.darwin.arm64

Make sure to replace the URL with the correct download link for the CLI version you need: https://github.com/xprotocol-org/xardian

2️⃣ Make the CLI executable

Once the download is complete, you need to make the file executable. Use the ls command to check that the file has been downloaded correctly:

You should see runner.linux.amd64 in the list. Now, change its permissions to make it executable by running:

chmod +x runner.linux.amd64

3️⃣ Run the Xardian CLI

Now that the file is executable, you can start it. Note: In Linux, you must precede the filename with ./ to run an executable from the current directory.

Run the CLI with:

./runner.linux.amd64

Take a look at the output to understand the syntax of the program:

4️⃣ Delegate

Before fully setting up, you'll need to complete the delegation process. To do this, run the following command:

./runner.linux.amd64 delegate

The program will walk you through the steps for delegation. Copy the generated URL and open it in your browser. On the XProtocol site, click "Connect Wallet" to link your wallet. Make sure you have some Base ETH for gas fees.

After assigning, enter your public wallet address into the console and press enter. You'll then see a confirmation message: "Delegation Successful."

5️⃣ Receive Rewards

After completing the delegation process, you can start running your node to begin receiving rewards. Run this command:

./runner.linux.amd64 run

If your node is running correctly, you should see something like this:

By default, if you disconnect from the VPS (close your terminal or lose your connection), your node will stop running. To prevent this, you can use the nohup command, which allows you to run your node after disconnecting the VPS.


Credit to DEPINspirationHUB for helping with the VPS video tutorial.

⚙️ Troubleshooting

  • "Command not found" error: If you get this error when trying to run the CLI, make sure you're using ./runner.linux.amd64. On Linux and macOS, executables need to be preceded by ./ when running from the current directory.

  • Download issues: If you don’t use wget or curl, you’ll need to manually download the file on your local machine and then transfer it to your VPS using FTP, which adds more steps.


📘FAQ

How do I import my wallet?
  • ./runner.linux.amd64 import --key private_key --addresses publicaddress1,publicaddress2

  • replace private_key with the private key of the Xardian operator wallet and publicaddress1,publicaddress2 with the delegated address(es)

Is it possible to switch to a different RPC?

Yes, we've introduced support for HTTPS-based RPC endpoints. Once the UI allows updating the RPC URL, users will have the flexibility to switch to secure RPC connections. Be sure to update to the latest version to access this feature.

How do I import several keys in my CLI server?

Delegation is handled at the wallet level, so you don't need to delegate for each individual key. You only need to delegate once for the entire wallet.

Can I delegate more than one wallet?

Yes, you can delegate multiple wallets. Simply update to the latest version, then run the delegate command for each wallet you want to delegate.

How do I check my xKICK rewards?

You can import the xKICK contract to your preferred wallet: 0xB51eFF119Ce6a238f67db7cA48431C3D319C7211

What does this message mean: Submission already exists for the latest challenge, skipping assertion submission

This is a feature introduced in version 0.0.3. When the app starts or reconnects after a network issue, it checks if the current challenge has already been submitted. If it has, the app skips re-submitting it. If not, it processes the submission. This helps ensure that users with unstable connections don't miss out on rewards.

How do I export my operator wallet's private key?

./runner.linux.amd64 export. Be sure to update to the latest version to access this command.

Last updated