dcrseeder is a crawler for the Decred network, which exposes a list of reliable nodes via a built-in HTTP server.
When dcrseeder is started for the first time, it will connect to the dcrd node
specified in config, send a getaddrs request, expecting an addr
message response. This message contains hostnames and IPs of peers known by the
node. dcrseeder will then connect to each of these peers, send a getaddrs
request, and will continue traversing the network in this fashion. dcrseeder
maintains a list of all known peers and periodically checks that they are
online and available. The list is stored on disk in a json file, so on
subsequent start ups the dcrd node specified in config does not need to be
online.
When dcrseeder is queried for node information, it responds with details of a random selection of the reliable nodes it knows about.
Go 1.20 or newer.
To build and install from a checked-out repo, run go install in the repo's
root directory.
To start dcrseeder listening on localhost:8000 with an initial connection to working testnet node 192.168.0.1:
$ ./dcrseeder --testnet.enabled --testnet.seeder 192.168.0.1 --testnet.listen=localhost:8000
You will then need to redirect HTTPS traffic on your public IP to localhost:8000
An example configuration file lists the full set of options available.
The integrated github issue tracker is used for this project.
dcrseeder is licensed under the copyfree ISC License.