Commands

This page will give a short overview of the different commands you can run from your node, and the syntax for using them.

Attention

If you’ve used previous versions of HOPR based around the HOPR Chat app, please be aware that the syntax for many commands has changed. In particular, all commands which required multiple inputs in HOPR Chat must be entered on a single line in hoprd.

To access the list of available commands, type help. If you incorrectly enter a command, your node will try to suggest the correct syntax. The list below is grouped by function.

info

Type info to display information about your HOPR Node, including the bootstrap node it’s currently connected to.

version

Type version to see the version of hoprd that you’re running.

address

Type address to see the two addresses associated with your node. The top address is your HOPR address, which is used for interacting with other nodes in the HOPR network which includes sending and receiving messages. By default, this only shows the last five characters. Click them to expand and see the full address.

The bottom address is your native address, used for funding with native and HOPR tokens.

Attention

The HOPR client is still under development. Please do NOT add funds to the HOPR node that you can’t lose.

settings

Type settings to see your current settings. This will show whether you’re currently including your address with sent messages (includeRecipient true / false), and your current channel opening strategy (promiscuous / passive). To change your includeRecipient setting, type settings includeRecipient true or settings includeRecipient false. To change your funding strategy, type settings strategy promiscuous or settings strategy passive.

ping

Type ping [HOPR address] to attempt to pings another node. You should receive a pong and a latency report. This can be used to assess the health of the target node and your own node.

peers

Type peers to see a list of nodes your node has discovered and established a connection to. Your node will use this list of peers when it attempts to send and route messages and automatically open payment channels.

send

Type send [HOPR address] [message] to send a message to the specified HOPR address. If you want them to know who sent it, ensure that you’ve set your includeRecipient setting to true. Your node will attempt to find the best route to send this message based on its knowledge of the network.

alias

You can use the alias command to give an address a more memorable name. Type alias [address] [alias]. And your node will assign the alias to that address. You can now use that alias in commands like send, instead of typing the full address. Note that these aliases are not available publicly, and will reset when you restart your node.

balance

Type balance to display your current HOPR and native balances.

Attention

The HOPR client is running by default on xDAI, so balance will show the xDAI balance as well as the wxHOPR balance. For more information see here

withdraw

Type withdraw [amount] [native / hopr] [address] to withdraw the specified amount of native or HOPR tokens to the target address. Ensure you have sufficient native tokens in your balance to pay for the gas fees.

open

Type open [HOPR addresss] [HOPR amount] to manually opens a payment channel to the specified node and fund it with the specified amount of HOPR tokens. Make sure you have sufficient native tokens to pay the gas fees.

channels

Type channels to see your currently open channels. You’ll see the node that each channel is open to and the amount with which they’re funded.

close

Type close [HOPR address] to close an open channel. Once you’ve initiated channel closure, you have to wait at least two minutes and then send the command again. This is a cool down period to give the other party in the channel sufficient time to redeem their tickets.

tickets

Type tickets to displays information about your redeemed and unredeemed tickets. Tickets are earned by relaying data and can be redeemed for HOPR tokens.

redeemTickets

Type redeemTickets to attempt to redeem your earned tickets for HOPR. Make sure you have sufficient native currency in your balance to cover the gas fees.

covertraffic

Type covertraffic start to being generating cover traffic messages. Type covertraffic stop to stop the cover traffic. You can type covertraffic stats to see the current status and reliability of your cover traffic.

quit

Type quit to terminate your node.