Troubleshooting
Troubleshooting HOPR node issues
How to check if the migration from HOPRd v2 to HOPRd v3 was successful?
-
Connect to your node via the HOPR Admin UI. If you encounter an error while connecting to your node, first try a hard refresh of the Admin UI (macOS: Cmd + Shift + R, Windows: Ctrl + Shift + R). If that doesn’t resolve the issue, refer to the error codes for further troubleshooting.
-
Ensure you are using the latest versions of both HOPRd and the HOPR Admin UI.
-
On the INFO page, navigate to the Network section:
- If the Eligible status displays Yes, your node has successfully joined the HOPRd network.
- If it displays No, and your node was recently created, it must reach 100% sync before becoming eligible.
-
On the TICKETS page, ensure that there are no Neglected or Rejected tickets and that you have already received some Unredeemed or Redeemed tickets.
How to check if my node is performing normally?
-
Verify successful HOPR Admin UI connection to your node
Connect to your node via the HOPR Admin UI. If you encounter an error while trying to connect to your node, please refer to the error codes.
-
Check for latest HOPRd & HOPR Admin UI versions
Ensure you are using the latest versions of both HOPRd and the HOPR Admin UI.
-
Check node health
-
On the INFO page, navigate to the Network section:
- If the Eligible status displays Yes, your node has successfully joined the HOPRd network.
- If it displays No, and your node was recently created, it must reach 100% sync before becoming eligible.
-
On the INFO page, under the Network section, verify that the Sync process is at 100%.
-
On the INFO page, under the Network section, verify that no Faulty RPC message appears next to the Provider Address.
-
On the INFO page, check the Balances section and confirm that the xDai: Node balance is at least 0.03 xDai.
-
On the INFO page, scroll to the Nodes on the network section and ensure the Announced node count exceeds 1061 and the Connected node count is above 100.
-
-
Check node configuration
On the Configuration page, under the Strategies section, verify the following:
- The !Aggregating setting is not enabled.
- The minimum_redeem_ticket_value is set between 1 wxHOPR and 9 wxHOPR.
- The redeem_only_aggregated setting is set to false.
-
Check your node connectivity quality
On the PEERS page, ensure that most of your peers have 100% quality (assuming your node has been running for at least 1 hour).
-
Verify tickets status
On the TICKETS page, ensure that there are no Unredeemed, Neglected or Rejected tickets.
-
Verify your node's status on the Network Dashboard
Visit HOPR Network Dashboard and search for your node by entering your Node address. If your node appears, it indicates that it is reachable by network nodes.
noteIf one of above mentioned steps doesn't meet requirements, please refer to the topics on this troubleshooting page. If you are still unable to find a solution, feel free to reach out to the Ambassadors via Telegram or Discord channels for further assistance.
How can I verify if Cover Traffic is being relayed through my node(s) and if I'm receiving rewards?
-
Ensure your node is performing normally
Ensure your node is functioning correctly by following the steps outlined in the troubleshooting guide.
-
Check incoming channels
Once connected to your node via the Admin UI, navigate to the CHANNELS: IN page, ensure you have at least 5 incoming payment channels from the following Cover Traffic nodes:
0xd30f8f6e5865d7ec947e101b1d6a183e9776ba40
0x5a5bf3d3ce59cd304f198b86c1a78adfadf31f83
0xa4642c066c1f8927db9d34abab599af784a2cff0
0xcbe8726c80cc0d7751b9545dd5a4b5b0e53e383d
0x764d3162a4024c5cba8817446ef563b27aa57598 -
Expected rewards calculation
Due to recent changes in ticket pricing and win probability, ticket aggregation has been discontinued. The current ticket price on the network is 0.00005 wxHOPR. Due to this low value, redeeming tickets frequently could quickly drain your xDai. To address this, the Cover Traffic Node now issues winning tickets valued at 10 wxHOPR each.
With an APR of 10%, a node staked at the maximum cap of 75,000 wxHOPR should earn approximately 20 wxHOPR per day. For nodes with a lower stake, you can estimate your expected rewards using the following formula:
Yearly Reward = (Your staking amount per node) × 10% (wxHOPR/year)
Daily Reward = (Yearly Reward) ÷ 365 (wxHOPR/day)Note: If you run multiple nodes, divide your total staking amount by the number of nodes to determine the staking amount per node.
Examples:
75,000 wxHOPR per node: Yearly Reward = 75,000 × 10% = 7,500 wxHOPR/year Daily Reward = 7,500 ÷ 365 ≈ 20.55 wxHOPR/day (approximately 2 tickets/day)
30,000 wxHOPR per node: Yearly Reward = 30,000 × 10% = 3,000 wxHOPR/year Daily Reward = 3,000 ÷ 365 ≈ 8.22 wxHOPR/day (approximately 1 ticket every 2 days)
10,000 wxHOPR per node: Yearly Reward = 10,000 × 10% = 1,000 wxHOPR/year Daily Reward = 1,000 ÷ 365 ≈ 2.74 wxHOPR/day (approximately 1 ticket every 4 days)
Note: These calculations assume optimal node performance and no issues with the RPC provider or other dependencies.
-
Verify Connectivity to Cover Traffic Nodes
To ensure stable connectivity and eligibility for rewards, try pinging each Cover Traffic node individually. If you can successfully ping all of them, it indicates that you have a stable connection to the Cover Traffic nodes. Below are the current addresses of the Cover Traffic nodes:
Cover Traffic node 1
Node address: 0xd30f8f6e5865d7ec947e101b1d6a183e9776ba40
Cover Traffic node 2
Node address: 0x5a5bf3d3ce59cd304f198b86c1a78adfadf31f83
Cover Traffic node 3
Node address: 0xa4642c066c1f8927db9d34abab599af784a2cff0
Cover Traffic node 4
Node address: 0xcbe8726c80cc0d7751b9545dd5a4b5b0e53e383d
Cover Traffic node 5
Node address: 0x764d3162a4024c5cba8817446ef563b27aa57598
What should I do if my node is receiving unredeemed, neglected, rejected tickets?
If your node is receiving rejected tickets, several issues could be causing this, such as:
- Your node is not properly synced, which may indicate limitations with your RPC provider.
- There may be off-chain issues where the node deems tickets invalid and marks them as rejected.
Follow these steps to troubleshoot the issue:
-
Connect to your node via the HOPR Admin UI.
-
Navigate to the Info page, under the Network section, and verify that no Faulty RPC message appears next to the Provider Address. If a Faulty RPC message is displayed, you must change your RPC provider and resync your node. Follow the guide to resync your node for detailed instructions.
-
If no Faulty RPC message appears next to the Provider Address, do the following:
- Navigate to the Channels: In page. Close all incoming payment channels by clicking the Close Incoming Channel icon next to each channel.
- If you have outgoing payment channels to Cover Traffic nodes, close the payment channels with Cover Traffic nodes and re-open at least one payment channel with a random peer from the connected peers list.
- Wait several days and monitor whether you receive rejected tickets again. If you do, contact the ambassadors on the Telegram channel or Discord server for assistance.
What should I do if my node is receiving neglected tickets?
There might be several causes on why your node received neglected tickets:
-
Tickets are marked as neglected when you close an incoming payment channel with unredeemed value. Since the tickets were not redeemed during the closure, they will be labeled as neglected tickets. This typically occurs when your node experiences issues, such as rejected tickets. To prevent continuous loss of rewards, it’s important to address the underlying issue.
-
When a payment channel is closed and the node's strategy value for minimum_redeem_ticket_value is set higher than the value of the channel’s individual tickets, those tickets will be marked as neglected. This happens because the ticket value does not meet the minimum threshold specified by the strategy. In this case, you need to customize your node strategies by following this guide.
How to re-sync my HOPRd node?
During the re-sync process, all tickets in your database will be removed, including any unredeemed tickets. This step is necessary to ensure optimal node performance, but please be aware that unredeemed tickets will be lost.
Please select platform to re-sync node:
- Docker
- Docker Compose
- Dappnode
-
Stop your node: follow this guide to stop your HOPR node.
-
Backup your node: ensure you back up your node before proceeding. Refer to this guide for detailed backup instructions follow this guide.
-
Delete the necessary files: On your machine, navigate to the .hoprd-db-dufour folder and perform the following steps:
3.1 Delete the tbf file.
3.2 Locate the db folder and remove all files inside it.
-
Start your node: once the cleanup is done, start your node again by following this guide.
-
(Optional) If you want to use the fast synchronization feature during the re-sync process, follow the fast-sync guide.
-
Navigate to the compose folder and stop the hoprd services by running the following command:
COMPOSE_PROFILES=hoprd docker compose down
-
Backup your node: ensure you back up your node before proceeding. Refer to this guide for detailed backup instructions follow this guide.
-
Within the compose directory, go to hoprd_data, then hoprd, delete the tbf file. Then locate the db folder. Remove all files inside db folder.
-
Return to the main compose folder and restart the hoprd services by running the following command:
COMPOSE_PROFILES=hoprd docker compose up -d
-
(Optional) If you want to use the fast synchronization feature during the re-sync process, follow the fast-sync guide.
-
Connect to your DAppNode dashboard.
-
Backup your node identity: Before proceeding with the re-sync process, ensure you back up your node identity by follwing this guide.
-
Remove the volume for the HOPR package: Go to the Info tab. Under the All volumes section, locate the volume size and click the trash can icon to remove the package volume. This will delete the package storage, including all databases.
-
Restore your node identity: Follow this guide to restore your node identity.
-
(Optional) If you want to use the fast synchronization feature during the re-sync process, follow the fast-sync guide.
-
Verify the restore process: Go to the Logs tab. In the logs, you should see syncing process lines, indicating the restore was successful and the re-sync process is underway. Wait for the node to fully sync to 100%.
Example log:
2025-01-14T14:11:51.005595Z INFO ThreadId(04) chain_indexer::block: Sync progress to last known head indexer="rpc" progress=97.97430830039525 block=38036660 head=38038341
How to retrieve logs from your node?
- Docker
- Dappnode
-
Connect to your machine and execute the command
docker ps
. This will provide you with a list of Docker containers you are currently running. Among them, locate the container with the label europe-west3-docker.pkg.dev/hoprassociation/docker-images/hoprd:stable and note the container ID. -
Get the logs from the docker container using the following command:
docker logs -t <Your_Container_ID> >> <File_name.log>
. Replace <Your_Container_ID> with your docker container ID. Replace <File_name.log> with your container ID and <File_name.log> with your chosen file name. After executing the command, wait until it finishes writing the logs to the file.Example:
docker logs -t 4951b2990936 >> logs_from_hopr_node.log
-
Connect to your Dappnode dashboard.
-
Go to the HOPR package logs page.
-
On the right side, click the Download all button to download HOPR node logs.
Troubleshooting HOPR Admin UI issues
HTTP Status code 422
Error description: Your RPC provider is either unavailable or malfunctioning. Please switch to a functional RPC provider. If you are using a local RPC provider, please troubleshoot the issue.
Error message:
Error fetching: {"name":"APIError","status":422,"statusText":"Unprocessable Entity","description":"HTTP Status code 422"}
UNAUTHORIZED/Authenticaltion Failed
Error description: If you provided incorrect security token.
Error message:
ERROR
Unable to connect.
Error fetching: {"status":"UNAUTHORIZED","error":"authentication failed"}
Network Request Failed
Error description: If HOPR Admin can't connect to your node, please check if the provided API endpoint is correct, or if your node is working.
Error message:
ERROR
Unable to connect.
Unknown error: "Network request failed"
Balance Too Low
Error description: When your node has just been created, it will not be funded. You can't connect to the unfunded node.
Error message:
ERROR
Unable to connect.
Your xDai balance seems to low to operate the node.
Please top up your node.
Address: 0xa6512ad...657730b0313
Troubleshooting the migration from Avado
What should I do if "DappnodeWifi" and my Avado Wi-Fi network don't appear in my computer's Wi-Fi list?
Please select connection method to your Avado device:
- Connect using SSH
- Connect using external monitor and keyboard
-
Find your Avado internal IP address
-
To find the internal IP address of your Avado device, first connect to your router. Then follow only the 2nd step in this guide to identify your router’s gateway IP address.
-
Log in to your router by entering the router's gateway IP address into your browser's address bar. Since router interfaces vary, search for sections labeled DHCP Clients," Connected Devices," or Connected Clients. Within this section, look for the client named dappnode to find its associated IP address.
-
-
Connect to your Avado device
-
Connect to your Avado device by entering the following command into your terminal/windows powershell:
ssh dappnode@<avado_internal_ip_address>
Please replace <avado_internal_ip_address> with your Avado internal IP address.
Example:
-
If this is your first time connecting via SSH, you'll be prompted to confirm the connection to your node. Type yes and press enter. Next, you'll be asked to enter a password; the default password is
dappnode.s0
.noteOn Linux systems, the password entry will not display characters as you type. Ensure you enter the password correctly before pressing enter.
-
-
Finalise migration process
-
Once you've logged in, install kbd package:
sudo apt-get install -y kbd
-
Install the prerequisites using the following command:
sudo wget -O - https://prerequisites.dappnode.io | sudo bash
-
Install the dappnode package using the following command:
sudo wget -O - https://installer.dappnode.io | sudo bash
-
Once the installation is complete, please restart your Avado device by executing the following command:
sudo reboot
-
Please wait 5 minutes, then check if DappnodeWifi appears in your computer's Wi-Fi list. The default Wi-Fi password for Dappnode is
dappnode
.
-
-
Prerequisites for connection to your Avado device
Make sure you have:
- An external monitor & HDMI cable.
- External keyboard.
-
Connect to your Avado device
-
Connect your monitor to your Avado device using an HDMI cable.
-
Connect an external keyboard to your Avado device.
-
Connect an Ethernet cable to your Avado device.
-
Power on your monitor and Avado device, and wait for the login screen to appear. Log in using the following default credentials:
Username: dappnode
Password: dappnode.s0noteOn Linux systems, the password entry will not display characters as you type. Ensure you enter the password correctly before pressing enter.
-
-
Finalise migration process
-
Once you've logged in, install kbd package:
sudo apt-get install -y kbd
-
Install the prerequisites using the following command:
sudo wget -O - https://prerequisites.dappnode.io | sudo bash
-
Install the dappnode package using the following command:
sudo wget -O - https://installer.dappnode.io | sudo bash
-
Once the installation is complete, please restart your Avado device by executing the following command:
sudo reboot
-
Please wait 5 minutes, then check if DappnodeWifi appears in your computer's Wi-Fi list. The default Wi-Fi password for Dappnode is
dappnode
.
-
What should I do if only my Avado Wi-Fi appears but "DappnodeWifi" is missing from my computer's Wi-Fi list?
If the Avado Wi-Fi appears on your computer's Wi-Fi list, it suggests a problem with the USB's boot settings, as the device did not attempt to initiate the installation process. Please select connection method to your Avado device:
- Connect using SSH
- Connect using external monitor and keyboard
-
Prerequisites for connection to your Avado device
Make sure you have:
- Physical access to your Avado device
- Micro Phillips head screwdriver
- A bootable USB stick with Dappnode software
-
Avado disassembly guide: accessing the internal battery
-
Remove the power cable and any other cables from your Avado device.
-
Detach the bottom panel of your Avado using a micro Phillips screwdriver.
-
Carefully release the RAM module by gently pushing the two clips outward. The module will pop up slightly. Remove the angled module to expose the circular battery located beneath it.
-
Remove the battery and wait 10 minutes.
-
Reinsert the battery and the RAM module into the device, then secure the bottom panel by replacing and tightening the screws.
-
Re-attach the power supply and ethernet cable.
-
-
Finalise migration process
-
Power on the Avado device for 2 minutes.
-
Turn off Avado device.
-
Insert the bootable USB stick containing the Dappnode software and power the device back on.
-
Leave the device running for 15 minutes, then turn it off.
-
Remove the USB stick and power on the device again.
-
Wait for 5 minutes and check if DappnodeWifi has appeared in your computer's wifi list. The default Wi-Fi password for Dappnode is
dappnode
.
-
-
Prerequisites for connection to your Avado device
Make sure you have:
- An external monitor & HDMI cable.
- External keyboard.
- A bootable USB stick with Dappnode software
-
Connect to your Avado device
-
Connect your monitor to your Avado device using an HDMI cable.
-
Connect an external keyboard to your Avado device.
-
Connect an Ethernet cable to your Avado device.
-
Attach the bootable USB stick containing the Dappnode software to any Avado USB port.
-
-
Finalise migration process
-
Power on your monitor and Avado device and start pressing the Esc key until you enter the BIOS. This should be visible on the monitor you have connected.
-
Use the arrow keys to navigate to the Boot tab.
-
Under Boot Option Priorities, select Boot Option # and then change it to your attached USB.
-
Now, using your arrow keys, navigate to the Save & Exit tab and save your settings.
-
Your device should now restart and begin booting from your attached bootable USB stick with Dappnode software. You can now resume the initial installation method but now starting directly from the 3rd step.
-
What should I do if my Dappnode isn't reachable via Wi-Fi and I've forgotten the SSH password?
If you've forgotten the SSH password and cannot access your Dappnode, you will need to physically connect to the device and perform a reinstall of the Dappnode software.
-
Prerequisites for connection to your Avado device
Make sure you have:
- An external monitor & HDMI cable.
- External keyboard.
- A bootable USB stick with Dappnode software
-
Connect to your Avado device
-
Connect your monitor to your Avado device using an HDMI cable.
-
Connect an external keyboard to your Avado device.
-
Connect an Ethernet cable to your Avado device.
-
Attach the bootable USB stick containing the Dappnode software to any Avado USB port.
-
-
Finalise migration process
-
Power on your monitor and Avado device and start pressing the Esc key until you enter the BIOS. This should be visible on the monitor you have connected.
-
Use the arrow keys to navigate to the Boot tab.
-
Under Boot Option Priorities, select Boot Option # and then change it to your attached USB.
-
Now, using your arrow keys, navigate to the Save & Exit tab and save your settings.
-
Your device should now restart and begin booting from your attached bootable USB stick with Dappnode software. You can now resume the initial installation method but now starting directly from the 3rd step.
-