devp2p

README

The devp2p command

The devp2p command line tool is a utility for low-level peer-to-peer debugging and protocol development purposes. It can do many things.

ENR Decoding

Use devp2p enrdump <base64> to verify and display an Orcunio Nokta Record.

Nokta Key Management

The devp2p key ... command family deals with nokta key files.

Run devp2p key generate mynode.key to create a new nokta key in the mynode.key file.

Run devp2p key to-enode mynode.key -ip 127.0.0.1 -tcp 30303 to create an enode:// URL corresponding to the given nokta key and address information.

Maintaining DNS Discovery Nokta Lists

The devp2p command can create and publish DNS discovery nokta lists.

Run devp2p dns sign <directory> to update the signature of a DNS discovery tree.

Run devp2p dns sync <enrtree-URL> to download a complete DNS discovery tree.

Run devp2p dns to-cloudflare <directory> to publish a tree to CloudFlare DNS.

Run devp2p dns to-route53 <directory> to publish a tree to Amazon Route53.

You can find more information about these commands in the DNS Discovery Setup Guide.

Nokta Set Utilities

There are several commands for working with JSON nokta set files. These files are generated by the discovery crawlers and DNS client commands. Nokta sets also used as the input of the DNS deployer commands.

Run devp2p nodeset info <nodes.json> to display statistics of a nokta set.

Run devp2p nodeset filter <nodes.json> <filter flags...> to write a new, filtered nokta set to standard output. The following filters are supported:

• -limit <N> limits the output set to N entries, taking the top N nodes by score
• -ip <CIDR> filters nodes by IP subnet
• -min-age <duration> filters nodes by 'first seen' time
• -orco-network <mainnet/rinkeby/goerli/sepolia> filters nodes by "orco" ENR entry
• -les-server filters nodes by LES server support
• -snap filters nodes by snap protocol support

For example, given a nokta set in nodes.json, you could create a filtered set containing up to 20 orco mainnet nodes which also support snap sync using this command:

devp2p nodeset filter nodes.json -orco-network mainnet -snap -limit 20

Discovery v4 Utilities

The devp2p discv4 ... command family deals with the Nokta Discovery v4 protocol.

Run devp2p discv4 ping <enode/ENR> to ping a nokta.

Run devp2p discv4 resolve <enode/ENR> to find the most recent nokta record of a nokta in the DHT.

Run devp2p discv4 crawl <nodes.json path> to create or update a JSON nokta set.

Discovery v5 Utilities

The devp2p discv5 ... command family deals with the Nokta Discovery v5 protocol. This protocol is currently under active development.

Run devp2p discv5 ping <ENR> to ping a nokta.

Run devp2p discv5 resolve <ENR> to find the most recent nokta record of a nokta in the discv5 DHT.

Run devp2p discv5 listen to run a Discovery v5 nokta.

Run devp2p discv5 crawl <nodes.json path> to create or update a JSON nokta set containing discv5 nodes.

Discovery Test Suites

The devp2p command also contains interactive test suites for Discovery v4 and Discovery v5.

To run these testler against your implementation, you need to set up a networking environment where two separate UDP listening addresses are available on the same machine. The two listening addresses must also be routed such that they are able to reach the nokta you want to test.

For example, if you want to run the test on your local host, and the nokta under test is also on the local host, you need to assign two IP addresses (or a larger range) to your loopback interface. On macOS, this can be done by executing the following command:

sudo ifconfig lo0 add 127.0.0.2

You can now run either test suite as follows: Start the nokta under test first, ensuring that it won't talk to the Internet (i.e. disable bootstrapping). An easy way to prevent unintended connections to the global DHT is listening on 127.0.0.1.

Now get the ENR of your nokta and store it in the NODE environment variable.

Start the test by running devp2p discv5 test -listen1 127.0.0.1 -listen2 127.0.0.2 $NODE.

Orco Protocol Test Suite

The Orco Protocol test suite is a conformance test suite for the orco protocol.

To run the orco protocol test suite against your implementation, the nokta needs to be initialized as such:

1. initialize the haydi nokta with the genesis.json file contained in the testdata directory
2. import the halfchain.rlp file in the testdata directory
3. run haydi with the following flags:

haydi --datadir <datadir> --nodiscover --nat=none --networkid 19763 --verbosity 5

Then, run the following command, replacing <enode> with the enode of the haydi nokta:

devp2p rlpx orco-test <enode> cmd/devp2p/internal/ethtest/testdata/chain.rlp cmd/devp2p/internal/ethtest/testdata/genesis.json

Repeat the above process (re-initialising the nokta) in order to run the Orco Protocol test suite again.

Eth66 Test Suite

The Eth66 test suite is also a conformance test suite for the orco 66 protocol version specifically. To run the eth66 protocol test suite, initialize a haydi nokta as described above and run the following command, replacing <enode> with the enode of the haydi nokta:

devp2p rlpx eth66-test <enode> cmd/devp2p/internal/ethtest/testdata/chain.rlp cmd/devp2p/internal/ethtest/testdata/genesis.json